{
  "openapi": "3.1.0",
  "tags": [
    {
      "name": "addons"
    },
    {
      "name": "media"
    },
    {
      "name": "commerce"
    },
    {
      "name": "brands"
    },
    {
      "name": "orchestrator"
    }
  ],
  "info": {
    "title": "Ghostpull API",
    "version": "v1",
    "description": "Preview: this API may change before its first stable release. Use an account API key, created in the web app's settings, in the x-api-key header. Each operation names its permission. Keys can list Addons (their production versions), upload and read media, start runs and batches, follow and list the account's runs and batches, cancel and retry batches, make finished runs and batch items again with a note, and analyze a shop's brand from its web address, approve it and manage the account's brands. Importing media from a URL, the list of running runs, and managing billing or identity are not part of the public API. Each key has a limit of 300 calls per minute; a 429 response names the delay in Retry-After and details.retryAfterSeconds. The docs site's API reference does not send live API requests. Response objects may gain fields; clients should ignore fields they do not use."
  },
  "servers": [
    {
      "url": "https://ghostpull.com"
    }
  ],
  "paths": {
    "/api/v1/addons": {
      "get": {
        "operationId": "listAddons",
        "tags": [
          "addons"
        ],
        "summary": "List the account's available Addons",
        "description": "Returns the Addons your account can run, each with its inputs, displayed price in credits, output types and titled steps.\n\n- **Inputs:** each names whether it is required, its default and its allowed values.\n- **Credits:** none.\n\nNeeds an API key with the permission `addons:read`.",
        "responses": {
          "200": {
            "description": "The Addons",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addons": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "The Addon ID used in run URLs."
                          },
                          "title": {
                            "type": "string",
                            "description": "The Addon's display name."
                          },
                          "description": {
                            "type": "string",
                            "description": "What this Addon does."
                          },
                          "inputs": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 32,
                                  "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                },
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "asset/image",
                                    "asset/video",
                                    "asset/3d",
                                    "asset/json",
                                    "asset/vector",
                                    "string",
                                    "number",
                                    "prompt",
                                    "composition",
                                    "json",
                                    "brand",
                                    "product"
                                  ]
                                },
                                "headline": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "hint": {
                                  "type": "string"
                                },
                                "optional": {
                                  "type": "boolean"
                                },
                                "default": {
                                  "$ref": "#/components/schemas/__schema0"
                                },
                                "attachments": {
                                  "type": "object",
                                  "properties": {
                                    "types": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "enum": [
                                          "asset/image",
                                          "asset/video",
                                          "asset/3d",
                                          "asset/json",
                                          "asset/vector"
                                        ]
                                      }
                                    },
                                    "max": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "types"
                                  ]
                                },
                                "maxLength": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "options": {
                                  "anyOf": [
                                    {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1
                                      }
                                    },
                                    {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "number"
                                      }
                                    }
                                  ]
                                },
                                "optionLabels": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "suggestions": {
                                  "minItems": 1,
                                  "maxItems": 8,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 40
                                      },
                                      "text": {
                                        "type": "string",
                                        "minLength": 1
                                      }
                                    },
                                    "required": [
                                      "label",
                                      "text"
                                    ]
                                  }
                                },
                                "format": {
                                  "type": "string",
                                  "enum": [
                                    "aspect-ratio",
                                    "duration",
                                    "color"
                                  ]
                                },
                                "fills": {
                                  "type": "string",
                                  "maxLength": 32,
                                  "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                },
                                "include": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "description",
                                      "price",
                                      "images"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "id",
                                "type",
                                "headline"
                              ]
                            },
                            "description": "The input definitions for this Addon, including required fields, defaults and allowed values."
                          },
                          "pricing": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "credits": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "credits"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "rates": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "when": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "maxLength": 32,
                                            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                          },
                                          "additionalProperties": {
                                            "anyOf": [
                                              {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  {
                                                    "type": "number"
                                                  }
                                                ]
                                              },
                                              {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "anyOf": [
                                                    {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    {
                                                      "type": "number"
                                                    }
                                                  ]
                                                }
                                              }
                                            ]
                                          }
                                        },
                                        "credits": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "credits"
                                      ]
                                    }
                                  },
                                  "per": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                  }
                                },
                                "required": [
                                  "rates"
                                ]
                              }
                            ],
                            "description": "What one run costs in credits: `{ credits }` for every run, or `{ rates, per? }`: the first rate whose `when` matches the run's inputs (an input ID to one option value or a list of them; an omitted input counts with its default; the last rate has no `when`), times the value of the `per` input when there is one. A run reserves its price before it starts. Reading this list spends no credits."
                          },
                          "ui": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "string",
                                    "const": "prompt"
                                  },
                                  "output": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "required": [
                                  "template"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "string",
                                    "const": "drop-files"
                                  },
                                  "output": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "required": [
                                  "template"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "string",
                                    "const": "motion-studio"
                                  },
                                  "timeline": {
                                    "type": "boolean"
                                  },
                                  "addLayers": {
                                    "type": "boolean"
                                  },
                                  "output": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "required": [
                                  "template"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "string",
                                    "const": "form"
                                  },
                                  "results": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "output": {
                                          "type": "string",
                                          "maxLength": 32,
                                          "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 80
                                        }
                                      },
                                      "required": [
                                        "output",
                                        "label"
                                      ]
                                    }
                                  },
                                  "before": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                  },
                                  "needsOneOf": {
                                    "type": "array",
                                    "items": {
                                      "minItems": 2,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      }
                                    }
                                  },
                                  "savedSettings": {
                                    "type": "boolean"
                                  },
                                  "showWhen": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "maxLength": 32,
                                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                    },
                                    "additionalProperties": {
                                      "type": "object",
                                      "propertyNames": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      },
                                      "additionalProperties": {
                                        "anyOf": [
                                          {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              {
                                                "type": "number"
                                              }
                                            ]
                                          },
                                          {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "anyOf": [
                                                {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                {
                                                  "type": "number"
                                                }
                                              ]
                                            }
                                          }
                                        ]
                                      }
                                    }
                                  },
                                  "batch": {
                                    "type": "object",
                                    "properties": {
                                      "input": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      },
                                      "single": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "string",
                                          "maxLength": 32,
                                          "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                        }
                                      }
                                    },
                                    "required": [
                                      "input"
                                    ]
                                  },
                                  "redo": {
                                    "type": "object",
                                    "properties": {
                                      "input": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      },
                                      "choices": {
                                        "minItems": 1,
                                        "maxItems": 10,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[a-z][a-zA-Z0-9]{0,31}$"
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 80
                                            }
                                          },
                                          "required": [
                                            "key",
                                            "label"
                                          ]
                                        }
                                      },
                                      "problems": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      }
                                    },
                                    "required": [
                                      "input",
                                      "choices",
                                      "problems"
                                    ]
                                  },
                                  "choose": {
                                    "type": "object",
                                    "properties": {
                                      "addon": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      },
                                      "input": {
                                        "type": "string",
                                        "maxLength": 32,
                                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                      }
                                    },
                                    "required": [
                                      "addon",
                                      "input"
                                    ]
                                  }
                                },
                                "required": [
                                  "template"
                                ]
                              }
                            ]
                          },
                          "examples": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "asset/image",
                                    "asset/video"
                                  ]
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "type",
                                "url",
                                "label"
                              ]
                            }
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "asset/image",
                                    "asset/video",
                                    "asset/3d",
                                    "asset/json",
                                    "asset/vector",
                                    "string",
                                    "composition",
                                    "json"
                                  ]
                                },
                                "step": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "type",
                                "step"
                              ]
                            }
                          },
                          "steps": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "after": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "when": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                  },
                                  "additionalProperties": {
                                    "anyOf": [
                                      {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          {
                                            "type": "number"
                                          }
                                        ]
                                      },
                                      {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            {
                                              "type": "number"
                                            }
                                          ]
                                        }
                                      }
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "id",
                                "title",
                                "after"
                              ]
                            }
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "description",
                          "inputs",
                          "pricing",
                          "outputs",
                          "steps"
                        ]
                      }
                    }
                  },
                  "required": [
                    "addons"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission addons:read.",
                      "details": {
                        "permission": "addons:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-ghostpull-permission": "addons:read"
      }
    },
    "/api/v1/media/assets": {
      "get": {
        "operationId": "listMediaAssets",
        "tags": [
          "media"
        ],
        "summary": "List the media library",
        "description": "Returns the account's media library, uploaded or generated, newest first, each asset with its current version.\n\n- **Pages:** `limit` at a time (default 50, at most 100); pass `nextCursor` as `cursor` for the next page.\n- **Search:** `q` keeps the assets whose file name contains it, ignoring case.\n- **File URLs:** signed and expire; call again for fresh ones.\n\nNeeds an API key with the permission `media:read`.",
        "responses": {
          "200": {
            "description": "The library",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The stable asset ID, shared by its versions."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The immutable version number of this asset, starting at 1."
                          },
                          "visibility": {
                            "type": "string",
                            "enum": [
                              "library",
                              "kept",
                              "job"
                            ],
                            "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                          },
                          "asset": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/image"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/png",
                                      "image/jpeg",
                                      "image/gif",
                                      "image/webp",
                                      "image/svg+xml"
                                    ]
                                  },
                                  "srcSet": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url",
                                        "width"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/video"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "video/mp4",
                                      "video/webm",
                                      "video/quicktime"
                                    ]
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/3d"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "model/gltf-binary",
                                      "model/gltf+json"
                                    ]
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/json"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "application/json"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/vector"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/svg+xml"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/font"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "font/ttf",
                                      "font/otf"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              }
                            ],
                            "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                          },
                          "editable": {
                            "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                            "type": "boolean",
                            "const": true
                          },
                          "composition": {
                            "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                            "type": "object",
                            "properties": {
                              "version": {
                                "type": "number",
                                "const": 1
                              },
                              "name": {
                                "type": "string",
                                "minLength": 1
                              },
                              "width": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 8192
                              },
                              "height": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 8192
                              },
                              "duration": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "maximum": 3600
                              },
                              "fps": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 60
                              },
                              "loop": {
                                "type": "boolean"
                              },
                              "background": {
                                "type": "string",
                                "minLength": 1
                              },
                              "layers": {
                                "type": "array",
                                "items": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "x": {
                                          "type": "number"
                                        },
                                        "y": {
                                          "type": "number"
                                        },
                                        "width": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "height": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "rotation": {
                                          "type": "number"
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "scale": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "image"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        },
                                        "fit": {
                                          "type": "string",
                                          "enum": [
                                            "contain",
                                            "cover"
                                          ]
                                        },
                                        "cutoutOf": {
                                          "type": "string",
                                          "enum": [
                                            "person",
                                            "product"
                                          ]
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "x",
                                              "y",
                                              "width",
                                              "height",
                                              "rotation",
                                              "opacity",
                                              "scale"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind",
                                        "asset"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "x": {
                                          "type": "number"
                                        },
                                        "y": {
                                          "type": "number"
                                        },
                                        "width": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "height": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "rotation": {
                                          "type": "number"
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "scale": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "trim": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "loop": {
                                          "type": "boolean"
                                        },
                                        "volume": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "video"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/video"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "video/mp4",
                                                "video/webm",
                                                "video/quicktime"
                                              ]
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "thumbnail": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url"
                                              ]
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        },
                                        "fit": {
                                          "type": "string",
                                          "enum": [
                                            "contain",
                                            "cover"
                                          ]
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "x",
                                              "y",
                                              "width",
                                              "height",
                                              "rotation",
                                              "opacity",
                                              "scale",
                                              "volume"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind",
                                        "asset"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "trim": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "loop": {
                                          "type": "boolean"
                                        },
                                        "volume": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "audio"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/audio"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "audio/mpeg",
                                                "audio/wav",
                                                "audio/ogg",
                                                "audio/aac",
                                                "audio/mp4"
                                              ]
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "volume"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind",
                                        "asset"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "x": {
                                          "type": "number"
                                        },
                                        "y": {
                                          "type": "number"
                                        },
                                        "width": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "height": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "rotation": {
                                          "type": "number"
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "scale": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "text"
                                        },
                                        "text": {
                                          "type": "string"
                                        },
                                        "fontFamily": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "fontWeight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "fontStyle": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "fontSize": {
                                          "type": "number",
                                          "exclusiveMinimum": 0,
                                          "maximum": 1
                                        },
                                        "lineHeight": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "letterSpacing": {
                                          "type": "number",
                                          "minimum": -0.2,
                                          "maximum": 1
                                        },
                                        "textTransform": {
                                          "type": "string",
                                          "enum": [
                                            "none",
                                            "uppercase"
                                          ]
                                        },
                                        "lineBreaks": {
                                          "type": "string",
                                          "const": "explicit"
                                        },
                                        "color": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "align": {
                                          "type": "string",
                                          "enum": [
                                            "left",
                                            "center",
                                            "right"
                                          ]
                                        },
                                        "spans": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "fontFamily": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "fontWeight": {
                                                "type": "integer",
                                                "minimum": 100,
                                                "maximum": 900
                                              },
                                              "fontStyle": {
                                                "type": "string",
                                                "enum": [
                                                  "normal",
                                                  "italic"
                                                ]
                                              },
                                              "color": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "start": {
                                                "type": "integer",
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "end": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "start",
                                              "end"
                                            ]
                                          }
                                        },
                                        "path": {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "arc"
                                                },
                                                "center": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "radius": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "startAngle": {
                                                  "type": "number"
                                                },
                                                "sweepAngle": {
                                                  "type": "number",
                                                  "minimum": -360,
                                                  "maximum": 360
                                                },
                                                "fit": {
                                                  "type": "string",
                                                  "enum": [
                                                    "shrink",
                                                    "clip"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "radius",
                                                "sweepAngle"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "bezier"
                                                },
                                                "start": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "segments": {
                                                  "minItems": 1,
                                                  "maxItems": 64,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "control1": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y"
                                                        ]
                                                      },
                                                      "control2": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y"
                                                        ]
                                                      },
                                                      "end": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y"
                                                        ]
                                                      }
                                                    },
                                                    "required": [
                                                      "control1",
                                                      "control2",
                                                      "end"
                                                    ]
                                                  }
                                                },
                                                "fit": {
                                                  "type": "string",
                                                  "enum": [
                                                    "shrink",
                                                    "clip"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "start",
                                                "segments"
                                              ]
                                            }
                                          ]
                                        },
                                        "units": {
                                          "type": "object",
                                          "properties": {
                                            "by": {
                                              "type": "string",
                                              "enum": [
                                                "character",
                                                "word",
                                                "line"
                                              ]
                                            },
                                            "stagger": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "reverse": {
                                              "type": "boolean"
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "by",
                                            "stagger",
                                            "animate"
                                          ]
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "x",
                                              "y",
                                              "width",
                                              "height",
                                              "rotation",
                                              "opacity",
                                              "scale",
                                              "fontSize"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind",
                                        "text"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "x": {
                                          "type": "number"
                                        },
                                        "y": {
                                          "type": "number"
                                        },
                                        "width": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "height": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "rotation": {
                                          "type": "number"
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "scale": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "shape"
                                        },
                                        "shape": {
                                          "type": "string",
                                          "enum": [
                                            "rectangle",
                                            "ellipse",
                                            "path"
                                          ]
                                        },
                                        "points": {
                                          "minItems": 3,
                                          "maxItems": 64,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "prefixItems": [
                                              {
                                                "type": "number",
                                                "minimum": 0,
                                                "maximum": 1
                                              },
                                              {
                                                "type": "number",
                                                "minimum": 0,
                                                "maximum": 1
                                              }
                                            ],
                                            "items": false,
                                            "minItems": 2,
                                            "maxItems": 2
                                          }
                                        },
                                        "fill": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "stroke": {
                                          "type": "object",
                                          "properties": {
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 0.05
                                            }
                                          },
                                          "required": [
                                            "color",
                                            "width"
                                          ]
                                        },
                                        "radius": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "x",
                                              "y",
                                              "width",
                                              "height",
                                              "rotation",
                                              "opacity",
                                              "scale"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "role": {
                                          "type": "string",
                                          "enum": [
                                            "background",
                                            "subject",
                                            "logo",
                                            "headline",
                                            "subline",
                                            "cta",
                                            "label",
                                            "container",
                                            "pointer",
                                            "area"
                                          ]
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "hidden": {
                                          "type": "boolean"
                                        },
                                        "start": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "x": {
                                          "type": "number"
                                        },
                                        "y": {
                                          "type": "number"
                                        },
                                        "width": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "height": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "rotation": {
                                          "type": "number"
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "scale": {
                                          "type": "number",
                                          "minimum": 0
                                        },
                                        "kind": {
                                          "type": "string",
                                          "const": "three"
                                        },
                                        "scene": {
                                          "type": "object",
                                          "properties": {
                                            "camera": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "perspective"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "target": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "near": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "far": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "fov": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0,
                                                      "exclusiveMaximum": 180
                                                    }
                                                  },
                                                  "required": [
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "orthographic"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "target": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "near": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "far": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "height": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "kind"
                                                  ]
                                                }
                                              ]
                                            },
                                            "nodes": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "group"
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind"
                                                    ]
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "mesh"
                                                      },
                                                      "geometry": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "box"
                                                              },
                                                              "width": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              },
                                                              "height": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              },
                                                              "depth": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "width",
                                                              "height",
                                                              "depth"
                                                            ]
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sphere"
                                                              },
                                                              "radius": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "radius"
                                                            ]
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "plane"
                                                              },
                                                              "width": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              },
                                                              "height": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "width",
                                                              "height"
                                                            ]
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "cylinder"
                                                              },
                                                              "radiusTop": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "radiusBottom": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "height": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "radiusTop",
                                                              "radiusBottom",
                                                              "height"
                                                            ]
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "torus"
                                                              },
                                                              "radius": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              },
                                                              "tube": {
                                                                "type": "number",
                                                                "exclusiveMinimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "radius",
                                                              "tube"
                                                            ]
                                                          }
                                                        ]
                                                      },
                                                      "material": {
                                                        "type": "object",
                                                        "properties": {
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "opacity": {
                                                            "type": "number",
                                                            "minimum": 0,
                                                            "maximum": 1
                                                          },
                                                          "metalness": {
                                                            "type": "number",
                                                            "minimum": 0,
                                                            "maximum": 1
                                                          },
                                                          "roughness": {
                                                            "type": "number",
                                                            "minimum": 0,
                                                            "maximum": 1
                                                          },
                                                          "doubleSided": {
                                                            "type": "boolean"
                                                          }
                                                        }
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind",
                                                      "geometry"
                                                    ]
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "model"
                                                      },
                                                      "asset": {
                                                        "type": "object",
                                                        "properties": {
                                                          "type": {
                                                            "type": "string",
                                                            "const": "asset/3d"
                                                          },
                                                          "url": {
                                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                            "examples": [
                                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                            ],
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "key": {
                                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                            "examples": [
                                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                            ],
                                                            "type": "string",
                                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                          },
                                                          "name": {
                                                            "description": "The display name, such as the original file name.",
                                                            "examples": [
                                                              "shoe.png"
                                                            ],
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "mediaType": {
                                                            "type": "string",
                                                            "enum": [
                                                              "model/gltf-binary",
                                                              "model/gltf+json"
                                                            ]
                                                          },
                                                          "thumbnail": {
                                                            "type": "object",
                                                            "properties": {
                                                              "url": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "width": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991
                                                              },
                                                              "height": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991
                                                              }
                                                            },
                                                            "required": [
                                                              "url"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "type"
                                                        ]
                                                      },
                                                      "clip": {
                                                        "type": "object",
                                                        "properties": {
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "offset": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "speed": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "loop": {
                                                            "type": "boolean"
                                                          }
                                                        },
                                                        "required": [
                                                          "name"
                                                        ]
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind",
                                                      "asset"
                                                    ]
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "color": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "intensity": {
                                                        "type": "number",
                                                        "minimum": 0
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "ambient-light"
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind"
                                                    ]
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "color": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "intensity": {
                                                        "type": "number",
                                                        "minimum": 0
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "directional-light"
                                                      },
                                                      "target": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind"
                                                    ]
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "parentId": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "visible": {
                                                        "type": "boolean"
                                                      },
                                                      "position": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "rotation": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number"
                                                          },
                                                          "y": {
                                                            "type": "number"
                                                          },
                                                          "z": {
                                                            "type": "number"
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "scale": {
                                                        "type": "object",
                                                        "properties": {
                                                          "x": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "y": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "z": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "x",
                                                          "y",
                                                          "z"
                                                        ]
                                                      },
                                                      "animate": {
                                                        "type": "object",
                                                        "propertyNames": {
                                                          "type": "string",
                                                          "enum": [
                                                            "position.x",
                                                            "position.y",
                                                            "position.z",
                                                            "rotation.x",
                                                            "rotation.y",
                                                            "rotation.z",
                                                            "scale.x",
                                                            "scale.y",
                                                            "scale.z"
                                                          ]
                                                        },
                                                        "additionalProperties": {
                                                          "minItems": 1,
                                                          "type": "array",
                                                          "items": {
                                                            "type": "object",
                                                            "properties": {
                                                              "time": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "value": {
                                                                "type": "number"
                                                              },
                                                              "easing": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "linear",
                                                                  "ease-in",
                                                                  "ease-out",
                                                                  "ease-in-out",
                                                                  "step"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "time",
                                                              "value"
                                                            ]
                                                          }
                                                        }
                                                      },
                                                      "color": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "intensity": {
                                                        "type": "number",
                                                        "minimum": 0
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "point-light"
                                                      },
                                                      "distance": {
                                                        "type": "number",
                                                        "minimum": 0
                                                      },
                                                      "decay": {
                                                        "type": "number",
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind"
                                                    ]
                                                  }
                                                ]
                                              }
                                            },
                                            "background": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "exposure": {
                                              "type": "number",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "nodes"
                                          ]
                                        },
                                        "animate": {
                                          "type": "object",
                                          "propertyNames": {
                                            "type": "string",
                                            "enum": [
                                              "x",
                                              "y",
                                              "width",
                                              "height",
                                              "rotation",
                                              "opacity",
                                              "scale"
                                            ]
                                          },
                                          "additionalProperties": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "time": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "value": {
                                                  "type": "number"
                                                },
                                                "easing": {
                                                  "type": "string",
                                                  "enum": [
                                                    "linear",
                                                    "ease-in",
                                                    "ease-out",
                                                    "ease-in-out",
                                                    "step"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "time",
                                                "value"
                                              ]
                                            }
                                          }
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "kind",
                                        "scene"
                                      ]
                                    }
                                  ]
                                }
                              },
                              "fonts": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "family": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "weight": {
                                      "type": "integer",
                                      "minimum": 100,
                                      "maximum": 900
                                    },
                                    "style": {
                                      "type": "string",
                                      "enum": [
                                        "normal",
                                        "italic"
                                      ]
                                    },
                                    "file": {
                                      "type": "string",
                                      "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                    },
                                    "asset": {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "key": {
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        },
                                        "url": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "key",
                                        "mediaType"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "family",
                                    "weight",
                                    "style"
                                  ]
                                }
                              },
                              "masks": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "subject": {
                                      "type": "string",
                                      "enum": [
                                        "product",
                                        "person",
                                        "object"
                                      ]
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 200
                                    },
                                    "src": {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "subject",
                                    "label",
                                    "src"
                                  ]
                                }
                              },
                              "src": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ]
                              }
                            },
                            "required": [
                              "version",
                              "width",
                              "height",
                              "duration",
                              "layers"
                            ],
                            "x-ghostpull-asset": "composition"
                          }
                        },
                        "required": [
                          "id",
                          "version",
                          "visibility",
                          "asset"
                        ]
                      },
                      "description": "The current page of ready assets, newest first."
                    },
                    "nextCursor": {
                      "description": "Pass as cursor to get the next page; null means the last page.",
                      "examples": [
                        "0b7e2f44-1c3d-4a5b-8e9f-102132435465"
                      ],
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "assets",
                    "nextCursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission media:read.",
                      "details": {
                        "permission": "media:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "description": "The maximum number of assets to return, newest first."
          },
          {
            "in": "query",
            "name": "cursor",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "description": "The previous response's nextCursor. Leave it out for the first page."
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "description": "Keep file names containing this text, ignoring case."
          }
        ],
        "x-ghostpull-permission": "media:read"
      },
      "post": {
        "operationId": "startMediaUpload",
        "tags": [
          "media"
        ],
        "summary": "Start uploading a file to the media library",
        "description": "Creates a pending asset and returns where to upload its file.\n\n- **Supported files:** asset/image: image/png, image/jpeg, image/gif, image/webp (at most 52428800 bytes); asset/video: video/mp4, video/webm, video/quicktime (at most 2147483648 bytes); asset/3d: model/gltf-binary, model/gltf+json (at most 209715200 bytes); asset/json:  (at most 10485760 bytes).\n- **Fonts:** font/ttf, font/otf (at most 10485760 bytes), for a brand's ads: kept, never listed in the library. A font upload is refused without `licenceConfirmed: true`, which confirms that the font's licence allows use in ads. An agent asks the user in the chat whether it does and sends it only after an explicit yes.\n- **Then:** PUT the file to `upload.url` with every header in `upload.headers` and no API key, then call `completeMediaUpload` with `versionId`. A library asset is listed only after completion.\n- **Size:** `sizeBytes` must be the file's exact length; the URL signs it, and storage refuses a file of any other size.\n- **Upload URL:** valid for one hour. Storage refuses an overwrite; its errors are not the API's JSON errors.\n- **Pending:** an account may have at most 100 uploads or 10737418240 bytes waiting for completion; uncompleted ones end after a day.\n- **Retries:** not idempotent: a repeated call creates another asset, so keep the answer before uploading.\n- **Credits:** none.\n\nEach user or API key may call it 60 times a minute and 2,000 times a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `media:upload`.",
        "responses": {
          "201": {
            "description": "The asset; upload the bytes next",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "assetId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The asset ID to keep for getMediaAsset after completion."
                    },
                    "versionId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The version ID to pass to completeMediaUpload after uploading the bytes."
                    },
                    "upload": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "format": "uri",
                          "description": "A signed PUT URL, valid for one hour. Upload the file directly here without an API key. Treat the URL as a secret.",
                          "examples": [
                            "https://uploads.ghostpull.example/library/shoe.png?X-Amz-Expires=3600&X-Amz-Signature=…"
                          ]
                        },
                        "headers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string"
                          },
                          "description": "Send every header with the PUT, including Content-Type and If-None-Match: *. A successful upload cannot be overwritten.",
                          "examples": [
                            {
                              "Content-Type": "image/png",
                              "If-None-Match": "*"
                            }
                          ]
                        }
                      },
                      "required": [
                        "url",
                        "headers"
                      ],
                      "description": "Where to upload the bytes before completing the version."
                    }
                  },
                  "required": [
                    "assetId",
                    "versionId",
                    "upload"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `media.unsupported_media_type`, `media.vector_upload_refused`, `media.font_licence_required`, `media.file_too_large`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "media.unsupported_media_type": {
                    "summary": "media.unsupported_media_type",
                    "value": {
                      "code": "media.unsupported_media_type",
                      "error": "text/plain is not an asset media type",
                      "details": {
                        "contentType": "text/plain"
                      }
                    }
                  },
                  "media.vector_upload_refused": {
                    "summary": "media.vector_upload_refused",
                    "value": {
                      "code": "media.vector_upload_refused",
                      "error": "SVG files cannot be uploaded: import them from a URL instead"
                    }
                  },
                  "media.font_licence_required": {
                    "summary": "media.font_licence_required",
                    "value": {
                      "code": "media.font_licence_required",
                      "error": "Confirm that the font's licence allows use in ads: send licenceConfirmed: true"
                    }
                  },
                  "media.file_too_large": {
                    "summary": "media.file_too_large",
                    "value": {
                      "code": "media.file_too_large",
                      "error": "Files of this type may have at most 52428800 bytes, not 60000000",
                      "details": {
                        "bytes": 60000000,
                        "maxBytes": 52428800
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission media:upload.",
                      "details": {
                        "permission": "media:upload"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `media.too_many_pending_uploads`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "media.too_many_pending_uploads": {
                    "summary": "media.too_many_pending_uploads",
                    "value": {
                      "code": "media.too_many_pending_uploads",
                      "error": "An account may have at most 100 uploads or 10737418240 bytes waiting for completion; complete them or wait a day until they expire",
                      "details": {
                        "maxUploads": 100,
                        "maxBytes": 10737418240
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "The file name shown in the library, never a storage path.",
                    "examples": [
                      "shoe.png"
                    ]
                  },
                  "mediaType": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The file's MIME type. Send the returned upload headers unchanged; completion checks the file's type and first bytes.",
                    "examples": [
                      "image/png"
                    ]
                  },
                  "sizeBytes": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The file's exact size in bytes, at most the limit for its media type. The upload URL signs it: storage refuses a file of any other size.",
                    "examples": [
                      48213
                    ]
                  },
                  "licenceConfirmed": {
                    "description": "Required for a font: true says the customer confirmed that the font's licence allows use in ads.",
                    "type": "boolean",
                    "const": true
                  }
                },
                "required": [
                  "name",
                  "mediaType",
                  "sizeBytes"
                ]
              }
            }
          }
        },
        "x-ghostpull-permission": "media:upload"
      }
    },
    "/api/v1/media/assets/{assetId}": {
      "get": {
        "operationId": "getMediaAsset",
        "tags": [
          "media"
        ],
        "summary": "Get one asset",
        "description": "Returns one asset of the media library with its current version.\n\n- **File URLs:** signed and expire; call again for fresh ones.\n\nNeeds an API key with the permission `media:read`.",
        "responses": {
          "200": {
            "description": "The asset",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The stable asset ID, shared by its versions."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The immutable version number of this asset, starting at 1."
                    },
                    "visibility": {
                      "type": "string",
                      "enum": [
                        "library",
                        "kept",
                        "job"
                      ],
                      "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                    },
                    "asset": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/image"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "height": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "image/png",
                                "image/jpeg",
                                "image/gif",
                                "image/webp",
                                "image/svg+xml"
                              ]
                            },
                            "srcSet": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "url": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "url",
                                  "width"
                                ]
                              }
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/video"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "height": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "video/mp4",
                                "video/webm",
                                "video/quicktime"
                              ]
                            },
                            "duration": {
                              "type": "number",
                              "exclusiveMinimum": 0
                            },
                            "thumbnail": {
                              "type": "object",
                              "properties": {
                                "url": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "url"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/3d"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "model/gltf-binary",
                                "model/gltf+json"
                              ]
                            },
                            "thumbnail": {
                              "type": "object",
                              "properties": {
                                "url": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "url"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/json"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "application/json"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/vector"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "image/svg+xml"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/font"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "font/ttf",
                                "font/otf"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        }
                      ],
                      "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                    },
                    "editable": {
                      "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                      "type": "boolean",
                      "const": true
                    },
                    "composition": {
                      "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "number",
                          "const": 1
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1
                        },
                        "width": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "height": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "duration": {
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 3600
                        },
                        "fps": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 60
                        },
                        "loop": {
                          "type": "boolean"
                        },
                        "background": {
                          "type": "string",
                          "minLength": 1
                        },
                        "layers": {
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "image"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "fit": {
                                    "type": "string",
                                    "enum": [
                                      "contain",
                                      "cover"
                                    ]
                                  },
                                  "cutoutOf": {
                                    "type": "string",
                                    "enum": [
                                      "person",
                                      "product"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "trim": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "volume": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "video"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "fit": {
                                    "type": "string",
                                    "enum": [
                                      "contain",
                                      "cover"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale",
                                        "volume"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "trim": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "volume": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "audio"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/audio"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "audio/mpeg",
                                          "audio/wav",
                                          "audio/ogg",
                                          "audio/aac",
                                          "audio/mp4"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "volume"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "text"
                                  },
                                  "text": {
                                    "type": "string"
                                  },
                                  "fontFamily": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "fontWeight": {
                                    "type": "integer",
                                    "minimum": 100,
                                    "maximum": 900
                                  },
                                  "fontStyle": {
                                    "type": "string",
                                    "enum": [
                                      "normal",
                                      "italic"
                                    ]
                                  },
                                  "fontSize": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 1
                                  },
                                  "lineHeight": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "letterSpacing": {
                                    "type": "number",
                                    "minimum": -0.2,
                                    "maximum": 1
                                  },
                                  "textTransform": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "uppercase"
                                    ]
                                  },
                                  "lineBreaks": {
                                    "type": "string",
                                    "const": "explicit"
                                  },
                                  "color": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right"
                                    ]
                                  },
                                  "spans": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "fontFamily": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "fontWeight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "fontStyle": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "color": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "start": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "end": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "start",
                                        "end"
                                      ]
                                    }
                                  },
                                  "path": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "arc"
                                          },
                                          "center": {
                                            "type": "object",
                                            "properties": {
                                              "x": {
                                                "type": "number"
                                              },
                                              "y": {
                                                "type": "number"
                                              }
                                            },
                                            "required": [
                                              "x",
                                              "y"
                                            ]
                                          },
                                          "radius": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "startAngle": {
                                            "type": "number"
                                          },
                                          "sweepAngle": {
                                            "type": "number",
                                            "minimum": -360,
                                            "maximum": 360
                                          },
                                          "fit": {
                                            "type": "string",
                                            "enum": [
                                              "shrink",
                                              "clip"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "radius",
                                          "sweepAngle"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "bezier"
                                          },
                                          "start": {
                                            "type": "object",
                                            "properties": {
                                              "x": {
                                                "type": "number"
                                              },
                                              "y": {
                                                "type": "number"
                                              }
                                            },
                                            "required": [
                                              "x",
                                              "y"
                                            ]
                                          },
                                          "segments": {
                                            "minItems": 1,
                                            "maxItems": 64,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "control1": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "control2": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "end": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "control1",
                                                "control2",
                                                "end"
                                              ]
                                            }
                                          },
                                          "fit": {
                                            "type": "string",
                                            "enum": [
                                              "shrink",
                                              "clip"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "start",
                                          "segments"
                                        ]
                                      }
                                    ]
                                  },
                                  "units": {
                                    "type": "object",
                                    "properties": {
                                      "by": {
                                        "type": "string",
                                        "enum": [
                                          "character",
                                          "word",
                                          "line"
                                        ]
                                      },
                                      "stagger": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "reverse": {
                                        "type": "boolean"
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "by",
                                      "stagger",
                                      "animate"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale",
                                        "fontSize"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "text"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "shape"
                                  },
                                  "shape": {
                                    "type": "string",
                                    "enum": [
                                      "rectangle",
                                      "ellipse",
                                      "path"
                                    ]
                                  },
                                  "points": {
                                    "minItems": 3,
                                    "maxItems": 64,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "prefixItems": [
                                        {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        }
                                      ],
                                      "items": false,
                                      "minItems": 2,
                                      "maxItems": 2
                                    }
                                  },
                                  "fill": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "stroke": {
                                    "type": "object",
                                    "properties": {
                                      "color": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 0.05
                                      }
                                    },
                                    "required": [
                                      "color",
                                      "width"
                                    ]
                                  },
                                  "radius": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "three"
                                  },
                                  "scene": {
                                    "type": "object",
                                    "properties": {
                                      "camera": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "perspective"
                                              },
                                              "position": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "near": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "far": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "fov": {
                                                "type": "number",
                                                "exclusiveMinimum": 0,
                                                "exclusiveMaximum": 180
                                              }
                                            },
                                            "required": [
                                              "kind"
                                            ]
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "orthographic"
                                              },
                                              "position": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "near": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "far": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "height": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              }
                                            },
                                            "required": [
                                              "kind"
                                            ]
                                          }
                                        ]
                                      },
                                      "nodes": {
                                        "type": "array",
                                        "items": {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "group"
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "mesh"
                                                },
                                                "geometry": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "box"
                                                        },
                                                        "width": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "depth": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "width",
                                                        "height",
                                                        "depth"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sphere"
                                                        },
                                                        "radius": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radius"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "plane"
                                                        },
                                                        "width": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "width",
                                                        "height"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "cylinder"
                                                        },
                                                        "radiusTop": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "radiusBottom": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radiusTop",
                                                        "radiusBottom",
                                                        "height"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "torus"
                                                        },
                                                        "radius": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "tube": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radius",
                                                        "tube"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "material": {
                                                  "type": "object",
                                                  "properties": {
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "opacity": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "metalness": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "roughness": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "doubleSided": {
                                                      "type": "boolean"
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind",
                                                "geometry"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "model"
                                                },
                                                "asset": {
                                                  "type": "object",
                                                  "properties": {
                                                    "type": {
                                                      "type": "string",
                                                      "const": "asset/3d"
                                                    },
                                                    "url": {
                                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                      "examples": [
                                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                      ],
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "key": {
                                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                      "examples": [
                                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                      ],
                                                      "type": "string",
                                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                    },
                                                    "name": {
                                                      "description": "The display name, such as the original file name.",
                                                      "examples": [
                                                        "shoe.png"
                                                      ],
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "mediaType": {
                                                      "type": "string",
                                                      "enum": [
                                                        "model/gltf-binary",
                                                        "model/gltf+json"
                                                      ]
                                                    },
                                                    "thumbnail": {
                                                      "type": "object",
                                                      "properties": {
                                                        "url": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "width": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991
                                                        },
                                                        "height": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991
                                                        }
                                                      },
                                                      "required": [
                                                        "url"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "type"
                                                  ]
                                                },
                                                "clip": {
                                                  "type": "object",
                                                  "properties": {
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "offset": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "speed": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "loop": {
                                                      "type": "boolean"
                                                    }
                                                  },
                                                  "required": [
                                                    "name"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind",
                                                "asset"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "ambient-light"
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "directional-light"
                                                },
                                                "target": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "point-light"
                                                },
                                                "distance": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "decay": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            }
                                          ]
                                        }
                                      },
                                      "background": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "exposure": {
                                        "type": "number",
                                        "minimum": 0
                                      }
                                    },
                                    "required": [
                                      "nodes"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "scene"
                                ]
                              }
                            ]
                          }
                        },
                        "fonts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1
                              },
                              "weight": {
                                "type": "integer",
                                "minimum": 100,
                                "maximum": 900
                              },
                              "style": {
                                "type": "string",
                                "enum": [
                                  "normal",
                                  "italic"
                                ]
                              },
                              "file": {
                                "type": "string",
                                "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                              },
                              "asset": {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/font"
                                  },
                                  "key": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "font/ttf",
                                      "font/otf"
                                    ]
                                  },
                                  "url": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type",
                                  "key",
                                  "mediaType"
                                ]
                              }
                            },
                            "required": [
                              "family",
                              "weight",
                              "style"
                            ]
                          }
                        },
                        "masks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "subject": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "person",
                                  "object"
                                ]
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              "src": {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/image"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/png",
                                      "image/jpeg",
                                      "image/gif",
                                      "image/webp",
                                      "image/svg+xml"
                                    ]
                                  },
                                  "srcSet": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url",
                                        "width"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              }
                            },
                            "required": [
                              "subject",
                              "label",
                              "src"
                            ]
                          }
                        },
                        "src": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/image"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/png",
                                    "image/jpeg",
                                    "image/gif",
                                    "image/webp",
                                    "image/svg+xml"
                                  ]
                                },
                                "srcSet": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url",
                                      "width"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/video"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "video/mp4",
                                    "video/webm",
                                    "video/quicktime"
                                  ]
                                },
                                "duration": {
                                  "type": "number",
                                  "exclusiveMinimum": 0
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            }
                          ]
                        }
                      },
                      "required": [
                        "version",
                        "width",
                        "height",
                        "duration",
                        "layers"
                      ],
                      "x-ghostpull-asset": "composition"
                    }
                  },
                  "required": [
                    "id",
                    "version",
                    "visibility",
                    "asset"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission media:read.",
                      "details": {
                        "permission": "media:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Asset not found",
                      "details": {
                        "resource": "Asset"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "assetId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "media:read"
      }
    },
    "/api/v1/media/versions/{versionId}/complete": {
      "post": {
        "operationId": "completeMediaUpload",
        "tags": [
          "media"
        ],
        "summary": "Finish an upload to the media library",
        "description": "Checks the uploaded file of a version from `startMediaUpload` and makes it ready; returns the asset at that version.\n\n- **Before:** PUT the file to the version's `upload.url`.\n- **Retries:** a rejected file fails its version for good: correct the file or its declared size and start a new upload.\n- **Lost answer:** call `getMediaAsset` with the original `assetId` to check whether it became ready.\n- **File URLs:** signed and expire; call again for fresh ones.\n- **Credits:** none.\n\nNeeds an API key with the permission `media:upload`.",
        "responses": {
          "200": {
            "description": "The asset at this version",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The stable asset ID, shared by its versions."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The immutable version number of this asset, starting at 1."
                    },
                    "visibility": {
                      "type": "string",
                      "enum": [
                        "library",
                        "kept",
                        "job"
                      ],
                      "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                    },
                    "asset": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/image"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "height": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "image/png",
                                "image/jpeg",
                                "image/gif",
                                "image/webp",
                                "image/svg+xml"
                              ]
                            },
                            "srcSet": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "url": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "url",
                                  "width"
                                ]
                              }
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/video"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "height": {
                              "examples": [
                                1200
                              ],
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "video/mp4",
                                "video/webm",
                                "video/quicktime"
                              ]
                            },
                            "duration": {
                              "type": "number",
                              "exclusiveMinimum": 0
                            },
                            "thumbnail": {
                              "type": "object",
                              "properties": {
                                "url": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "url"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/3d"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "model/gltf-binary",
                                "model/gltf+json"
                              ]
                            },
                            "thumbnail": {
                              "type": "object",
                              "properties": {
                                "url": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "url"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/json"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "application/json"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/vector"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "image/svg+xml"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "asset/font"
                            },
                            "url": {
                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                              "examples": [
                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "key": {
                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                              "examples": [
                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                              ],
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "name": {
                              "description": "The display name, such as the original file name.",
                              "examples": [
                                "shoe.png"
                              ],
                              "type": "string",
                              "minLength": 1
                            },
                            "mediaType": {
                              "type": "string",
                              "enum": [
                                "font/ttf",
                                "font/otf"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ]
                        }
                      ],
                      "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                    },
                    "editable": {
                      "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                      "type": "boolean",
                      "const": true
                    },
                    "composition": {
                      "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "number",
                          "const": 1
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1
                        },
                        "width": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "height": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "duration": {
                          "type": "number",
                          "exclusiveMinimum": 0,
                          "maximum": 3600
                        },
                        "fps": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 60
                        },
                        "loop": {
                          "type": "boolean"
                        },
                        "background": {
                          "type": "string",
                          "minLength": 1
                        },
                        "layers": {
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "image"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "fit": {
                                    "type": "string",
                                    "enum": [
                                      "contain",
                                      "cover"
                                    ]
                                  },
                                  "cutoutOf": {
                                    "type": "string",
                                    "enum": [
                                      "person",
                                      "product"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "trim": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "volume": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "video"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "fit": {
                                    "type": "string",
                                    "enum": [
                                      "contain",
                                      "cover"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale",
                                        "volume"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "trim": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "volume": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "audio"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/audio"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "audio/mpeg",
                                          "audio/wav",
                                          "audio/ogg",
                                          "audio/aac",
                                          "audio/mp4"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "volume"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "asset"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "text"
                                  },
                                  "text": {
                                    "type": "string"
                                  },
                                  "fontFamily": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "fontWeight": {
                                    "type": "integer",
                                    "minimum": 100,
                                    "maximum": 900
                                  },
                                  "fontStyle": {
                                    "type": "string",
                                    "enum": [
                                      "normal",
                                      "italic"
                                    ]
                                  },
                                  "fontSize": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 1
                                  },
                                  "lineHeight": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "letterSpacing": {
                                    "type": "number",
                                    "minimum": -0.2,
                                    "maximum": 1
                                  },
                                  "textTransform": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "uppercase"
                                    ]
                                  },
                                  "lineBreaks": {
                                    "type": "string",
                                    "const": "explicit"
                                  },
                                  "color": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right"
                                    ]
                                  },
                                  "spans": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "fontFamily": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "fontWeight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "fontStyle": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "color": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "start": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "end": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "start",
                                        "end"
                                      ]
                                    }
                                  },
                                  "path": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "arc"
                                          },
                                          "center": {
                                            "type": "object",
                                            "properties": {
                                              "x": {
                                                "type": "number"
                                              },
                                              "y": {
                                                "type": "number"
                                              }
                                            },
                                            "required": [
                                              "x",
                                              "y"
                                            ]
                                          },
                                          "radius": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "startAngle": {
                                            "type": "number"
                                          },
                                          "sweepAngle": {
                                            "type": "number",
                                            "minimum": -360,
                                            "maximum": 360
                                          },
                                          "fit": {
                                            "type": "string",
                                            "enum": [
                                              "shrink",
                                              "clip"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "radius",
                                          "sweepAngle"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "bezier"
                                          },
                                          "start": {
                                            "type": "object",
                                            "properties": {
                                              "x": {
                                                "type": "number"
                                              },
                                              "y": {
                                                "type": "number"
                                              }
                                            },
                                            "required": [
                                              "x",
                                              "y"
                                            ]
                                          },
                                          "segments": {
                                            "minItems": 1,
                                            "maxItems": 64,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "control1": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "control2": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                },
                                                "end": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "control1",
                                                "control2",
                                                "end"
                                              ]
                                            }
                                          },
                                          "fit": {
                                            "type": "string",
                                            "enum": [
                                              "shrink",
                                              "clip"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "start",
                                          "segments"
                                        ]
                                      }
                                    ]
                                  },
                                  "units": {
                                    "type": "object",
                                    "properties": {
                                      "by": {
                                        "type": "string",
                                        "enum": [
                                          "character",
                                          "word",
                                          "line"
                                        ]
                                      },
                                      "stagger": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "reverse": {
                                        "type": "boolean"
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "by",
                                      "stagger",
                                      "animate"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale",
                                        "fontSize"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "text"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "shape"
                                  },
                                  "shape": {
                                    "type": "string",
                                    "enum": [
                                      "rectangle",
                                      "ellipse",
                                      "path"
                                    ]
                                  },
                                  "points": {
                                    "minItems": 3,
                                    "maxItems": 64,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "prefixItems": [
                                        {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        }
                                      ],
                                      "items": false,
                                      "minItems": 2,
                                      "maxItems": 2
                                    }
                                  },
                                  "fill": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "stroke": {
                                    "type": "object",
                                    "properties": {
                                      "color": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 0.05
                                      }
                                    },
                                    "required": [
                                      "color",
                                      "width"
                                    ]
                                  },
                                  "radius": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "role": {
                                    "type": "string",
                                    "enum": [
                                      "background",
                                      "subject",
                                      "logo",
                                      "headline",
                                      "subline",
                                      "cta",
                                      "label",
                                      "container",
                                      "pointer",
                                      "area"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "hidden": {
                                    "type": "boolean"
                                  },
                                  "start": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "x": {
                                    "type": "number"
                                  },
                                  "y": {
                                    "type": "number"
                                  },
                                  "width": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "height": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "rotation": {
                                    "type": "number"
                                  },
                                  "opacity": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "scale": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "three"
                                  },
                                  "scene": {
                                    "type": "object",
                                    "properties": {
                                      "camera": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "perspective"
                                              },
                                              "position": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "near": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "far": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "fov": {
                                                "type": "number",
                                                "exclusiveMinimum": 0,
                                                "exclusiveMaximum": 180
                                              }
                                            },
                                            "required": [
                                              "kind"
                                            ]
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "orthographic"
                                              },
                                              "position": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  },
                                                  "z": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y",
                                                  "z"
                                                ]
                                              },
                                              "near": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "far": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "height": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              }
                                            },
                                            "required": [
                                              "kind"
                                            ]
                                          }
                                        ]
                                      },
                                      "nodes": {
                                        "type": "array",
                                        "items": {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "group"
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "mesh"
                                                },
                                                "geometry": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "box"
                                                        },
                                                        "width": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "depth": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "width",
                                                        "height",
                                                        "depth"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sphere"
                                                        },
                                                        "radius": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radius"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "plane"
                                                        },
                                                        "width": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "width",
                                                        "height"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "cylinder"
                                                        },
                                                        "radiusTop": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "radiusBottom": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radiusTop",
                                                        "radiusBottom",
                                                        "height"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "torus"
                                                        },
                                                        "radius": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "tube": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "radius",
                                                        "tube"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "material": {
                                                  "type": "object",
                                                  "properties": {
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "opacity": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "metalness": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "roughness": {
                                                      "type": "number",
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "doubleSided": {
                                                      "type": "boolean"
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind",
                                                "geometry"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "model"
                                                },
                                                "asset": {
                                                  "type": "object",
                                                  "properties": {
                                                    "type": {
                                                      "type": "string",
                                                      "const": "asset/3d"
                                                    },
                                                    "url": {
                                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                      "examples": [
                                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                      ],
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "key": {
                                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                      "examples": [
                                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                      ],
                                                      "type": "string",
                                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                    },
                                                    "name": {
                                                      "description": "The display name, such as the original file name.",
                                                      "examples": [
                                                        "shoe.png"
                                                      ],
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "mediaType": {
                                                      "type": "string",
                                                      "enum": [
                                                        "model/gltf-binary",
                                                        "model/gltf+json"
                                                      ]
                                                    },
                                                    "thumbnail": {
                                                      "type": "object",
                                                      "properties": {
                                                        "url": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "width": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991
                                                        },
                                                        "height": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991
                                                        }
                                                      },
                                                      "required": [
                                                        "url"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "type"
                                                  ]
                                                },
                                                "clip": {
                                                  "type": "object",
                                                  "properties": {
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "offset": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "speed": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "loop": {
                                                      "type": "boolean"
                                                    }
                                                  },
                                                  "required": [
                                                    "name"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind",
                                                "asset"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "ambient-light"
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "directional-light"
                                                },
                                                "target": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "parentId": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "visible": {
                                                  "type": "boolean"
                                                },
                                                "position": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "rotation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number"
                                                    },
                                                    "y": {
                                                      "type": "number"
                                                    },
                                                    "z": {
                                                      "type": "number"
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "scale": {
                                                  "type": "object",
                                                  "properties": {
                                                    "x": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "y": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "z": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "x",
                                                    "y",
                                                    "z"
                                                  ]
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "position.x",
                                                      "position.y",
                                                      "position.z",
                                                      "rotation.x",
                                                      "rotation.y",
                                                      "rotation.z",
                                                      "scale.x",
                                                      "scale.y",
                                                      "scale.z"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                },
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "intensity": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "kind": {
                                                  "type": "string",
                                                  "const": "point-light"
                                                },
                                                "distance": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "decay": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "kind"
                                              ]
                                            }
                                          ]
                                        }
                                      },
                                      "background": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "exposure": {
                                        "type": "number",
                                        "minimum": 0
                                      }
                                    },
                                    "required": [
                                      "nodes"
                                    ]
                                  },
                                  "animate": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string",
                                      "enum": [
                                        "x",
                                        "y",
                                        "width",
                                        "height",
                                        "rotation",
                                        "opacity",
                                        "scale"
                                      ]
                                    },
                                    "additionalProperties": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "time": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "value": {
                                            "type": "number"
                                          },
                                          "easing": {
                                            "type": "string",
                                            "enum": [
                                              "linear",
                                              "ease-in",
                                              "ease-out",
                                              "ease-in-out",
                                              "step"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "time",
                                          "value"
                                        ]
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "scene"
                                ]
                              }
                            ]
                          }
                        },
                        "fonts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1
                              },
                              "weight": {
                                "type": "integer",
                                "minimum": 100,
                                "maximum": 900
                              },
                              "style": {
                                "type": "string",
                                "enum": [
                                  "normal",
                                  "italic"
                                ]
                              },
                              "file": {
                                "type": "string",
                                "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                              },
                              "asset": {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/font"
                                  },
                                  "key": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "font/ttf",
                                      "font/otf"
                                    ]
                                  },
                                  "url": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "type",
                                  "key",
                                  "mediaType"
                                ]
                              }
                            },
                            "required": [
                              "family",
                              "weight",
                              "style"
                            ]
                          }
                        },
                        "masks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "subject": {
                                "type": "string",
                                "enum": [
                                  "product",
                                  "person",
                                  "object"
                                ]
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              "src": {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/image"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/png",
                                      "image/jpeg",
                                      "image/gif",
                                      "image/webp",
                                      "image/svg+xml"
                                    ]
                                  },
                                  "srcSet": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url",
                                        "width"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              }
                            },
                            "required": [
                              "subject",
                              "label",
                              "src"
                            ]
                          }
                        },
                        "src": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/image"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/png",
                                    "image/jpeg",
                                    "image/gif",
                                    "image/webp",
                                    "image/svg+xml"
                                  ]
                                },
                                "srcSet": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url",
                                      "width"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/video"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "video/mp4",
                                    "video/webm",
                                    "video/quicktime"
                                  ]
                                },
                                "duration": {
                                  "type": "number",
                                  "exclusiveMinimum": 0
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            }
                          ]
                        }
                      },
                      "required": [
                        "version",
                        "width",
                        "height",
                        "duration",
                        "layers"
                      ],
                      "x-ghostpull-asset": "composition"
                    }
                  },
                  "required": [
                    "id",
                    "version",
                    "visibility",
                    "asset"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `media.upload_rejected`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "media.upload_rejected": {
                    "summary": "media.upload_rejected",
                    "value": {
                      "code": "media.upload_rejected",
                      "error": "The file has 48213 bytes, more than the 40000 declared",
                      "details": {
                        "reason": "larger_than_declared",
                        "bytes": 48213,
                        "declaredBytes": 40000
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission media:upload.",
                      "details": {
                        "permission": "media:upload"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Version not found",
                      "details": {
                        "resource": "Version"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `media.upload_missing`, `media.version_not_pending`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "media.upload_missing": {
                    "summary": "media.upload_missing",
                    "value": {
                      "code": "media.upload_missing",
                      "error": "Upload the file to its upload URL before completing it"
                    }
                  },
                  "media.version_not_pending": {
                    "summary": "media.version_not_pending",
                    "value": {
                      "code": "media.version_not_pending",
                      "error": "The version is ready, not pending",
                      "details": {
                        "status": "ready"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "versionId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "media:upload"
      }
    },
    "/api/v1/media/assets/{assetId}/download-url": {
      "get": {
        "operationId": "getMediaDownloadUrl",
        "tags": [
          "media"
        ],
        "summary": "Get a download link for a file",
        "description": "Returns a fresh signed URL, not the file itself, for the current ready version of an asset in your media library. GET the URL directly to download the original file as an attachment with its file name. Whoever has the URL can download the file until it expires after 15 minutes, so do not share or store it; request another when needed. Deleted assets are not available. For a bulk download, request each selected asset and package the files in your client. File bytes go directly from storage to your client.\n\nNeeds an API key with the permission `media:read`.",
        "responses": {
          "200": {
            "description": "The attachment URL, file name and size",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri",
                      "description": "Signed attachment URL, valid for 15 minutes."
                    },
                    "name": {
                      "type": "string",
                      "description": "The suggested download file name."
                    },
                    "sizeBytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file size before ZIP packaging, in bytes."
                    }
                  },
                  "required": [
                    "url",
                    "name",
                    "sizeBytes"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission media:read.",
                      "details": {
                        "permission": "media:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Asset not found",
                      "details": {
                        "resource": "Asset"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "assetId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "media:read"
      }
    },
    "/api/v1/commerce/catalogs": {
      "get": {
        "operationId": "listCatalogs",
        "tags": [
          "commerce"
        ],
        "summary": "List the account's product catalogs",
        "description": "Returns the account's catalogs, oldest first, each with its shop system, the currency of its prices and how many products it holds.\n\n- **Then:** `listProducts` with a catalog's `id` as `catalogId`.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The catalogs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "catalogs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "examples": [
                              "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                            ]
                          },
                          "name": {
                            "type": "string",
                            "examples": [
                              "Nordfaden Shopify"
                            ]
                          },
                          "shopSystem": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "shopify",
                                  "shopware",
                                  "woocommerce"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The shop system its products come from; null for products made in Ghostpull"
                          },
                          "currency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$",
                            "examples": [
                              "EUR"
                            ]
                          },
                          "productCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "examples": [
                              1240
                            ]
                          },
                          "images": {
                            "description": "How far its shop images are loaded into Media; in the list of catalogs",
                            "type": "object",
                            "properties": {
                              "total": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "examples": [
                                  5000
                                ]
                              },
                              "loaded": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "examples": [
                                  2350
                                ]
                              },
                              "failed": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "examples": [
                                  12
                                ]
                              }
                            },
                            "required": [
                              "total",
                              "loaded",
                              "failed"
                            ]
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "examples": [
                              "2026-11-02T10:00:00.000Z"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "shopSystem",
                          "currency",
                          "productCount",
                          "createdAt"
                        ]
                      }
                    }
                  },
                  "required": [
                    "catalogs"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-ghostpull-permission": "products:read"
      },
      "post": {
        "operationId": "createCatalog",
        "tags": [
          "commerce"
        ],
        "summary": "Create a product catalog",
        "description": "Creates an empty catalog with its name and the ISO 4217 currency of its prices: with a shop system for the products of one shop, imported from its exports, or without one for products made in Ghostpull one by one. An account has at most 20 catalogs.\n\n- **Then:** with a shop system, `startProductImport` imports a product file into it, or `importCatalogProducts` sends products in batches; without one, `createProduct` makes its products.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "201": {
            "description": "The new catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "examples": [
                        "Nordfaden Shopify"
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system its products come from; null for products made in Ghostpull"
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$",
                      "examples": [
                        "EUR"
                      ]
                    },
                    "productCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        1240
                      ]
                    },
                    "images": {
                      "description": "How far its shop images are loaded into Media; in the list of catalogs",
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            5000
                          ]
                        },
                        "loaded": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            2350
                          ]
                        },
                        "failed": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            12
                          ]
                        }
                      },
                      "required": [
                        "total",
                        "loaded",
                        "failed"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-02T10:00:00.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "shopSystem",
                    "currency",
                    "productCount",
                    "createdAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.too_many_catalogs`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.too_many_catalogs": {
                    "summary": "commerce.too_many_catalogs",
                    "value": {
                      "code": "commerce.too_many_catalogs",
                      "error": "An account has at most 20 catalogs.",
                      "details": {
                        "max": 20
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "The user's name for the catalog, e.g. the shop's"
                  },
                  "shopSystem": {
                    "description": "The shop system whose exports the catalog imports; left out for products made in Ghostpull with createProduct",
                    "type": "string",
                    "enum": [
                      "shopify",
                      "shopware",
                      "woocommerce"
                    ]
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$",
                    "examples": [
                      "EUR"
                    ],
                    "description": "The currency of every price in the catalog"
                  }
                },
                "required": [
                  "name",
                  "currency"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/catalogs/{catalogId}": {
      "patch": {
        "operationId": "updateCatalog",
        "tags": [
          "commerce"
        ],
        "summary": "Rename a catalog or correct its currency",
        "description": "Changes a catalog's name, the currency of its prices, or both, and answers the catalog; its shop system stays. Changing the currency does not convert prices.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "The changed catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "examples": [
                        "Nordfaden Shopify"
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system its products come from; null for products made in Ghostpull"
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$",
                      "examples": [
                        "EUR"
                      ]
                    },
                    "productCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        1240
                      ]
                    },
                    "images": {
                      "description": "How far its shop images are loaded into Media; in the list of catalogs",
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            5000
                          ]
                        },
                        "loaded": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            2350
                          ]
                        },
                        "failed": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            12
                          ]
                        }
                      },
                      "required": [
                        "total",
                        "loaded",
                        "failed"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-02T10:00:00.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "shopSystem",
                    "currency",
                    "productCount",
                    "createdAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "The user's name for the catalog, e.g. the shop's"
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$",
                    "examples": [
                      "EUR"
                    ],
                    "description": "The currency of every price in the catalog"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      },
      "delete": {
        "operationId": "deleteCatalog",
        "tags": [
          "commerce"
        ],
        "summary": "Delete a catalog with its products",
        "description": "Deletes the catalog with all its products, variants and images. Images already imported into the media library stay there.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "204": {
            "description": "Deleted"
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/catalogs/{catalogId}/products": {
      "post": {
        "operationId": "importCatalogProducts",
        "tags": [
          "commerce"
        ],
        "summary": "Import a batch of products into a catalog",
        "description": "Inserts new products into the catalog and updates changed ones by their `externalId`, replacing a product's variants and images with the batch's; a product sent unchanged is only counted. Answers how many products were created, updated and unchanged.\n\n- **Before:** make one `importId` (a UUID) for the import and send it with each of its batches, at most 200 products and 2 MB a batch.\n- **Then:** after the last batch, `getCatalogImport` counts the catalog's products the import did not send, and `removeMissingProducts` removes them.\n- **Retries:** sending a batch again is safe; products are matched by `externalId`.\n- **Limits:** 50000 products per catalog; one invalid product refuses the whole batch, naming its index. Each user or API key may call it 600 times a minute; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "What the batch did",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "created": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        120
                      ]
                    },
                    "updated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        30
                      ]
                    },
                    "unchanged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        50
                      ]
                    }
                  },
                  "required": [
                    "created",
                    "updated",
                    "unchanged"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.catalog_full`, `commerce.catalog_without_shop_system`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.catalog_full": {
                    "summary": "commerce.catalog_full",
                    "value": {
                      "code": "commerce.catalog_full",
                      "error": "A catalog holds at most 50000 products.",
                      "details": {
                        "max": 50000
                      }
                    }
                  },
                  "commerce.catalog_without_shop_system": {
                    "summary": "commerce.catalog_without_shop_system",
                    "value": {
                      "code": "commerce.catalog_without_shop_system",
                      "error": "The catalog holds products made in Ghostpull; import into a catalog of a shop."
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Request body too large: `request_too_large`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "request_too_large": {
                    "summary": "request_too_large",
                    "value": {
                      "code": "request_too_large",
                      "error": "The request body exceeds 2097152 bytes",
                      "details": {
                        "maxBytes": 2097152
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "importId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "One ID the client makes for the whole import and sends with each of its batches"
                  },
                  "products": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "externalId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255,
                          "description": "The product's ID in its source, unique within its catalog: Shopify's handle, Shopware's id, WooCommerce's ID",
                          "examples": [
                            "classic-hoodie"
                          ]
                        },
                        "handle": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "descriptionHtml": {
                          "type": "string",
                          "maxLength": 65536
                        },
                        "brand": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "productType": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "categories": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 512
                          }
                        },
                        "tags": {
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          }
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "active",
                            "draft",
                            "archived"
                          ]
                        },
                        "options": {
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "examples": [
                                  "Size"
                                ]
                              },
                              "values": {
                                "maxItems": 100,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255
                                },
                                "examples": [
                                  [
                                    "S",
                                    "M",
                                    "L"
                                  ]
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "values"
                            ]
                          }
                        },
                        "attributes": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "examples": [
                                  "Size"
                                ]
                              },
                              "values": {
                                "maxItems": 100,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255
                                },
                                "examples": [
                                  [
                                    "S",
                                    "M",
                                    "L"
                                  ]
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "values"
                            ]
                          }
                        },
                        "variants": {
                          "minItems": 1,
                          "maxItems": 2048,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "externalId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "description": "The variant's ID in its source, unique within its product",
                                "examples": [
                                  "HOOD-S"
                                ]
                              },
                              "title": {
                                "examples": [
                                  "Classic Hoodie - S"
                                ],
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255
                              },
                              "sku": {
                                "examples": [
                                  "HOOD-S"
                                ],
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255
                              },
                              "barcode": {
                                "description": "The GTIN, EAN, UPC or ISBN as the shop exports it; free text, neither checked nor unique",
                                "examples": [
                                  "4006381333931"
                                ],
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255
                              },
                              "price": {
                                "type": "string",
                                "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                                "examples": [
                                  "19.90"
                                ]
                              },
                              "compareAtPrice": {
                                "description": "The higher price the variant was sold at before",
                                "type": "string",
                                "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                                "examples": [
                                  "19.90"
                                ]
                              },
                              "optionValues": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255
                                },
                                "additionalProperties": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255
                                },
                                "description": "Option name to value; empty when the source names no options",
                                "examples": [
                                  {
                                    "Size": "S"
                                  }
                                ]
                              },
                              "attributes": {
                                "description": "What only this variant has; what all variants share stays on the product",
                                "examples": [
                                  [
                                    {
                                      "name": "Material",
                                      "values": [
                                        "Organic cotton"
                                      ]
                                    }
                                  ]
                                ],
                                "maxItems": 100,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 255,
                                      "examples": [
                                        "Size"
                                      ]
                                    },
                                    "values": {
                                      "maxItems": 100,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 255
                                      },
                                      "examples": [
                                        [
                                          "S",
                                          "M",
                                          "L"
                                        ]
                                      ]
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "values"
                                  ]
                                }
                              },
                              "imagePositions": {
                                "description": "The positions of the product's images that show this variant, the first its main one",
                                "examples": [
                                  [
                                    2
                                  ]
                                ],
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 2147483647
                                }
                              }
                            },
                            "required": [
                              "externalId",
                              "optionValues"
                            ]
                          }
                        },
                        "images": {
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri",
                                "description": "The image on the shop's server",
                                "examples": [
                                  "https://cdn.shop.example/hoodie-front.jpg"
                                ]
                              },
                              "alt": {
                                "examples": [
                                  "Classic hoodie, front"
                                ],
                                "type": "string",
                                "maxLength": 512
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 2147483647,
                                "description": "1 is the product's main image",
                                "examples": [
                                  1
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "position"
                            ]
                          }
                        }
                      },
                      "required": [
                        "externalId",
                        "title",
                        "categories",
                        "tags",
                        "status",
                        "options",
                        "attributes",
                        "variants",
                        "images"
                      ]
                    }
                  }
                },
                "required": [
                  "importId",
                  "products"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/catalogs/{catalogId}/imports/{importId}": {
      "get": {
        "operationId": "getCatalogImport",
        "tags": [
          "commerce"
        ],
        "summary": "Count the products an import did not send",
        "description": "Answers how many of the catalog's products the import with this `importId` did not send: the products `removeMissingProducts` would remove.\n\n- **Before:** every batch of the import is stored. An import that stored no product of the catalog answers 0.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The import's missing products",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "missing": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The catalog's products this import did not send",
                      "examples": [
                        37
                      ]
                    }
                  },
                  "required": [
                    "missing"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "importId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:read"
      }
    },
    "/api/v1/commerce/catalogs/{catalogId}/imports/{importId}/missing": {
      "delete": {
        "operationId": "removeMissingProducts",
        "tags": [
          "commerce"
        ],
        "summary": "Remove the products an import did not send",
        "description": "Deletes the catalog's products, with their variants and images, that the import with this `importId` did not send, and answers how many it removed.\n\n- **Before:** every batch of the import is stored, or the file import is `done`, and the file was a full export: a selection or a search lacks products the shop still has. Refused while an import of the catalog runs. A product another import sent into the catalog meanwhile is removed too. An import that stored no product of the catalog answers 404 and removes nothing.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "How many were removed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "removed": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        37
                      ]
                    }
                  },
                  "required": [
                    "removed"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.import_running`, `commerce.import_state`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.import_running": {
                    "summary": "commerce.import_running",
                    "value": {
                      "code": "commerce.import_running",
                      "error": "Another import of this catalog is running."
                    }
                  },
                  "commerce.import_state": {
                    "summary": "commerce.import_state",
                    "value": {
                      "code": "commerce.import_state",
                      "error": "The import is importing; this step is not possible now.",
                      "details": {
                        "state": "importing"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "importId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/imports": {
      "get": {
        "operationId": "listProductImports",
        "tags": [
          "commerce"
        ],
        "summary": "List running product imports",
        "description": "Answers the account's imports that are being read or import products, newest first.\n\n- **Polling:** every few seconds while one runs.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The running imports",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "imports": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "catalogId": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The catalog it imports into, once it was started"
                          },
                          "fileName": {
                            "type": "string",
                            "examples": [
                              "products_export.csv"
                            ]
                          },
                          "bytes": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The file's size; 0 while the Platform still fetches it from a URL",
                            "examples": [
                              2481337
                            ]
                          },
                          "shopSystem": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "shopify",
                                  "shopware",
                                  "woocommerce"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The shop system whose export the file is, once it was read"
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "uploading",
                              "reading",
                              "ready",
                              "importing",
                              "done",
                              "failed"
                            ]
                          },
                          "preview": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "products": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "examples": [
                                      1240
                                    ]
                                  },
                                  "variants": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "examples": [
                                      3712
                                    ]
                                  },
                                  "images": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "examples": [
                                      2980
                                    ]
                                  },
                                  "titles": {
                                    "maxItems": 20,
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    },
                                    "description": "The first products' titles",
                                    "examples": [
                                      [
                                        "Classic hoodie",
                                        "Canvas tote"
                                      ]
                                    ]
                                  },
                                  "skipped": {
                                    "maxItems": 100,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "row": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 9007199254740991
                                        },
                                        "reason": {
                                          "type": "string",
                                          "enum": [
                                            "missing_id",
                                            "missing_title",
                                            "unreadable_price",
                                            "orphan_variant",
                                            "no_readable_variant",
                                            "invalid_image_url",
                                            "invalid_product",
                                            "duplicate_id"
                                          ]
                                        },
                                        "field": {
                                          "type": "string",
                                          "enum": [
                                            "externalId",
                                            "handle",
                                            "title",
                                            "descriptionHtml",
                                            "brand",
                                            "productType",
                                            "categories",
                                            "tags",
                                            "status",
                                            "options",
                                            "attributes",
                                            "variants",
                                            "images"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "row",
                                        "reason"
                                      ]
                                    },
                                    "description": "The first rows the import leaves out, with their reason"
                                  },
                                  "skippedCount": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "How many rows the import leaves out in all",
                                    "examples": [
                                      2
                                    ]
                                  }
                                },
                                "required": [
                                  "products",
                                  "variants",
                                  "images",
                                  "titles",
                                  "skipped",
                                  "skippedCount"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "written": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Products stored so far while it imports",
                            "examples": [
                              600
                            ]
                          },
                          "created": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "examples": [
                              580
                            ]
                          },
                          "updated": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "examples": [
                              12
                            ]
                          },
                          "unchanged": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "examples": [
                              8
                            ]
                          },
                          "error": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "code": {
                                    "type": "string",
                                    "examples": [
                                      "commerce.file_unreadable"
                                    ]
                                  },
                                  "details": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {}
                                  }
                                },
                                "required": [
                                  "code"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "examples": [
                              "2026-11-03T10:00:00.000Z"
                            ]
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "examples": [
                              "2026-11-03T10:00:12.000Z"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "catalogId",
                          "fileName",
                          "bytes",
                          "shopSystem",
                          "state",
                          "preview",
                          "written",
                          "created",
                          "updated",
                          "unchanged",
                          "error",
                          "createdAt",
                          "updatedAt"
                        ]
                      }
                    }
                  },
                  "required": [
                    "imports"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-ghostpull-permission": "products:read"
      },
      "post": {
        "operationId": "createProductImport",
        "tags": [
          "commerce"
        ],
        "summary": "Create a product file import",
        "description": "Creates an import for one product export of Shopify, Shopware or WooCommerce, as CSV of at most 50 MB, and answers where to upload the file.\n\n- **Then:** PUT the file to `upload.url` with `upload.headers`, then `readProductImport`.\n- **Limits:** Each user or API key may call it 30 times an hour; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "201": {
            "description": "The import and its upload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "import": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        "catalogId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The catalog it imports into, once it was started"
                        },
                        "fileName": {
                          "type": "string",
                          "examples": [
                            "products_export.csv"
                          ]
                        },
                        "bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The file's size; 0 while the Platform still fetches it from a URL",
                          "examples": [
                            2481337
                          ]
                        },
                        "shopSystem": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "shopify",
                                "shopware",
                                "woocommerce"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The shop system whose export the file is, once it was read"
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "uploading",
                            "reading",
                            "ready",
                            "importing",
                            "done",
                            "failed"
                          ]
                        },
                        "preview": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "products": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "examples": [
                                    1240
                                  ]
                                },
                                "variants": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "examples": [
                                    3712
                                  ]
                                },
                                "images": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "examples": [
                                    2980
                                  ]
                                },
                                "titles": {
                                  "maxItems": 20,
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  },
                                  "description": "The first products' titles",
                                  "examples": [
                                    [
                                      "Classic hoodie",
                                      "Canvas tote"
                                    ]
                                  ]
                                },
                                "skipped": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "row": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 9007199254740991
                                      },
                                      "reason": {
                                        "type": "string",
                                        "enum": [
                                          "missing_id",
                                          "missing_title",
                                          "unreadable_price",
                                          "orphan_variant",
                                          "no_readable_variant",
                                          "invalid_image_url",
                                          "invalid_product",
                                          "duplicate_id"
                                        ]
                                      },
                                      "field": {
                                        "type": "string",
                                        "enum": [
                                          "externalId",
                                          "handle",
                                          "title",
                                          "descriptionHtml",
                                          "brand",
                                          "productType",
                                          "categories",
                                          "tags",
                                          "status",
                                          "options",
                                          "attributes",
                                          "variants",
                                          "images"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "row",
                                      "reason"
                                    ]
                                  },
                                  "description": "The first rows the import leaves out, with their reason"
                                },
                                "skippedCount": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "How many rows the import leaves out in all",
                                  "examples": [
                                    2
                                  ]
                                }
                              },
                              "required": [
                                "products",
                                "variants",
                                "images",
                                "titles",
                                "skipped",
                                "skippedCount"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "written": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Products stored so far while it imports",
                          "examples": [
                            600
                          ]
                        },
                        "created": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            580
                          ]
                        },
                        "updated": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            12
                          ]
                        },
                        "unchanged": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "examples": [
                            8
                          ]
                        },
                        "error": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string",
                                  "examples": [
                                    "commerce.file_unreadable"
                                  ]
                                },
                                "details": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {}
                                }
                              },
                              "required": [
                                "code"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "examples": [
                            "2026-11-03T10:00:00.000Z"
                          ]
                        },
                        "updatedAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "examples": [
                            "2026-11-03T10:00:12.000Z"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "catalogId",
                        "fileName",
                        "bytes",
                        "shopSystem",
                        "state",
                        "preview",
                        "written",
                        "created",
                        "updated",
                        "unchanged",
                        "error",
                        "createdAt",
                        "updatedAt"
                      ]
                    },
                    "upload": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "format": "uri",
                          "description": "A signed PUT URL, valid for one hour. Upload the file directly here without an API key. Treat the URL as a secret.",
                          "examples": [
                            "https://uploads.ghostpull.example/library/shoe.png?X-Amz-Expires=3600&X-Amz-Signature=…"
                          ]
                        },
                        "headers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string"
                          },
                          "description": "Send every header with the PUT, including Content-Type and If-None-Match: *. A successful upload cannot be overwritten.",
                          "examples": [
                            {
                              "Content-Type": "image/png",
                              "If-None-Match": "*"
                            }
                          ]
                        }
                      },
                      "required": [
                        "url",
                        "headers"
                      ]
                    }
                  },
                  "required": [
                    "import",
                    "upload"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                      "products_export.csv"
                    ]
                  },
                  "bytes": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 52428800,
                    "description": "The file's exact size in bytes. The upload URL signs it: storage refuses a file of any other size.",
                    "examples": [
                      2481337
                    ]
                  }
                },
                "required": [
                  "fileName",
                  "bytes"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/imports/from-url": {
      "post": {
        "operationId": "importProductFileFromUrl",
        "tags": [
          "commerce"
        ],
        "summary": "Import a product file from a URL",
        "description": "Downloads a product export of Shopify, Shopware or WooCommerce from a public https URL, as CSV of at most 50 MB, and reads it as the shop system its header row names; answers the import as `reading`. Nothing is stored in a catalog yet.\n\n- **Polling:** `getProductImport` until it is `ready` with its preview, or `failed`.\n- **Then:** `startProductImport`.\n- **Limits:** the download must finish within 45 seconds; for slower sources, upload the file with `createProductImport`. Each user or API key may call it 30 times an hour; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "202": {
            "description": "The import, reading",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "catalogId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The catalog it imports into, once it was started"
                    },
                    "fileName": {
                      "type": "string",
                      "examples": [
                        "products_export.csv"
                      ]
                    },
                    "bytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file's size; 0 while the Platform still fetches it from a URL",
                      "examples": [
                        2481337
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system whose export the file is, once it was read"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "uploading",
                        "reading",
                        "ready",
                        "importing",
                        "done",
                        "failed"
                      ]
                    },
                    "preview": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "products": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                1240
                              ]
                            },
                            "variants": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                3712
                              ]
                            },
                            "images": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                2980
                              ]
                            },
                            "titles": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "The first products' titles",
                              "examples": [
                                [
                                  "Classic hoodie",
                                  "Canvas tote"
                                ]
                              ]
                            },
                            "skipped": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "row": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  "reason": {
                                    "type": "string",
                                    "enum": [
                                      "missing_id",
                                      "missing_title",
                                      "unreadable_price",
                                      "orphan_variant",
                                      "no_readable_variant",
                                      "invalid_image_url",
                                      "invalid_product",
                                      "duplicate_id"
                                    ]
                                  },
                                  "field": {
                                    "type": "string",
                                    "enum": [
                                      "externalId",
                                      "handle",
                                      "title",
                                      "descriptionHtml",
                                      "brand",
                                      "productType",
                                      "categories",
                                      "tags",
                                      "status",
                                      "options",
                                      "attributes",
                                      "variants",
                                      "images"
                                    ]
                                  }
                                },
                                "required": [
                                  "row",
                                  "reason"
                                ]
                              },
                              "description": "The first rows the import leaves out, with their reason"
                            },
                            "skippedCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many rows the import leaves out in all",
                              "examples": [
                                2
                              ]
                            }
                          },
                          "required": [
                            "products",
                            "variants",
                            "images",
                            "titles",
                            "skipped",
                            "skippedCount"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "written": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Products stored so far while it imports",
                      "examples": [
                        600
                      ]
                    },
                    "created": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        580
                      ]
                    },
                    "updated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        12
                      ]
                    },
                    "unchanged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        8
                      ]
                    },
                    "error": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "string",
                              "examples": [
                                "commerce.file_unreadable"
                              ]
                            },
                            "details": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "code"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:00.000Z"
                      ]
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:12.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "fileName",
                    "bytes",
                    "shopSystem",
                    "state",
                    "preview",
                    "written",
                    "created",
                    "updated",
                    "unchanged",
                    "error",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `media.public_file_rejected`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "media.public_file_rejected": {
                    "summary": "media.public_file_rejected",
                    "value": {
                      "code": "media.public_file_rejected",
                      "error": "Files must be on a public host",
                      "details": {
                        "reason": "private_host"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 4096,
                    "format": "uri",
                    "description": "Where the Platform downloads the CSV, a public https URL",
                    "examples": [
                      "https://shop.example/exports/products_export.csv"
                    ]
                  },
                  "fileName": {
                    "examples": [
                      "products_export.csv"
                    ],
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/imports/{importId}": {
      "get": {
        "operationId": "getProductImport",
        "tags": [
          "commerce"
        ],
        "summary": "Get a product import",
        "description": "Answers where the import stands: `reading` its file, `ready` with its preview (products, variants, images, the first titles and the rows it leaves out), `importing` with the products written so far, `done` with how many were created, updated and unchanged, or `failed` with an error code.\n\n- **Polling:** every few seconds while it is `reading` or `importing`.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The import",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "catalogId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The catalog it imports into, once it was started"
                    },
                    "fileName": {
                      "type": "string",
                      "examples": [
                        "products_export.csv"
                      ]
                    },
                    "bytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file's size; 0 while the Platform still fetches it from a URL",
                      "examples": [
                        2481337
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system whose export the file is, once it was read"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "uploading",
                        "reading",
                        "ready",
                        "importing",
                        "done",
                        "failed"
                      ]
                    },
                    "preview": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "products": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                1240
                              ]
                            },
                            "variants": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                3712
                              ]
                            },
                            "images": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                2980
                              ]
                            },
                            "titles": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "The first products' titles",
                              "examples": [
                                [
                                  "Classic hoodie",
                                  "Canvas tote"
                                ]
                              ]
                            },
                            "skipped": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "row": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  "reason": {
                                    "type": "string",
                                    "enum": [
                                      "missing_id",
                                      "missing_title",
                                      "unreadable_price",
                                      "orphan_variant",
                                      "no_readable_variant",
                                      "invalid_image_url",
                                      "invalid_product",
                                      "duplicate_id"
                                    ]
                                  },
                                  "field": {
                                    "type": "string",
                                    "enum": [
                                      "externalId",
                                      "handle",
                                      "title",
                                      "descriptionHtml",
                                      "brand",
                                      "productType",
                                      "categories",
                                      "tags",
                                      "status",
                                      "options",
                                      "attributes",
                                      "variants",
                                      "images"
                                    ]
                                  }
                                },
                                "required": [
                                  "row",
                                  "reason"
                                ]
                              },
                              "description": "The first rows the import leaves out, with their reason"
                            },
                            "skippedCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many rows the import leaves out in all",
                              "examples": [
                                2
                              ]
                            }
                          },
                          "required": [
                            "products",
                            "variants",
                            "images",
                            "titles",
                            "skipped",
                            "skippedCount"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "written": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Products stored so far while it imports",
                      "examples": [
                        600
                      ]
                    },
                    "created": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        580
                      ]
                    },
                    "updated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        12
                      ]
                    },
                    "unchanged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        8
                      ]
                    },
                    "error": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "string",
                              "examples": [
                                "commerce.file_unreadable"
                              ]
                            },
                            "details": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "code"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:00.000Z"
                      ]
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:12.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "fileName",
                    "bytes",
                    "shopSystem",
                    "state",
                    "preview",
                    "written",
                    "created",
                    "updated",
                    "unchanged",
                    "error",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Import not found",
                      "details": {
                        "resource": "Import"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "importId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:read"
      }
    },
    "/api/v1/commerce/imports/{importId}/read": {
      "post": {
        "operationId": "readProductImport",
        "tags": [
          "commerce"
        ],
        "summary": "Read an uploaded product file",
        "description": "Reads the uploaded file as the shop system's export its header row names, or as `shopSystem`, and answers the import as `reading`. Nothing is stored yet.\n\n- **Before:** the file is uploaded.\n- **Polling:** `getProductImport` until it is `ready` with its preview, or `failed`.\n- **Then:** `startProductImport`.\n- **Retries:** reading again is safe, also with another `shopSystem`.\n- **Limits:** Each user or API key may call it 30 times an hour; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "202": {
            "description": "The import, reading",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "catalogId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The catalog it imports into, once it was started"
                    },
                    "fileName": {
                      "type": "string",
                      "examples": [
                        "products_export.csv"
                      ]
                    },
                    "bytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file's size; 0 while the Platform still fetches it from a URL",
                      "examples": [
                        2481337
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system whose export the file is, once it was read"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "uploading",
                        "reading",
                        "ready",
                        "importing",
                        "done",
                        "failed"
                      ]
                    },
                    "preview": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "products": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                1240
                              ]
                            },
                            "variants": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                3712
                              ]
                            },
                            "images": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                2980
                              ]
                            },
                            "titles": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "The first products' titles",
                              "examples": [
                                [
                                  "Classic hoodie",
                                  "Canvas tote"
                                ]
                              ]
                            },
                            "skipped": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "row": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  "reason": {
                                    "type": "string",
                                    "enum": [
                                      "missing_id",
                                      "missing_title",
                                      "unreadable_price",
                                      "orphan_variant",
                                      "no_readable_variant",
                                      "invalid_image_url",
                                      "invalid_product",
                                      "duplicate_id"
                                    ]
                                  },
                                  "field": {
                                    "type": "string",
                                    "enum": [
                                      "externalId",
                                      "handle",
                                      "title",
                                      "descriptionHtml",
                                      "brand",
                                      "productType",
                                      "categories",
                                      "tags",
                                      "status",
                                      "options",
                                      "attributes",
                                      "variants",
                                      "images"
                                    ]
                                  }
                                },
                                "required": [
                                  "row",
                                  "reason"
                                ]
                              },
                              "description": "The first rows the import leaves out, with their reason"
                            },
                            "skippedCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many rows the import leaves out in all",
                              "examples": [
                                2
                              ]
                            }
                          },
                          "required": [
                            "products",
                            "variants",
                            "images",
                            "titles",
                            "skipped",
                            "skippedCount"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "written": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Products stored so far while it imports",
                      "examples": [
                        600
                      ]
                    },
                    "created": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        580
                      ]
                    },
                    "updated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        12
                      ]
                    },
                    "unchanged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        8
                      ]
                    },
                    "error": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "string",
                              "examples": [
                                "commerce.file_unreadable"
                              ]
                            },
                            "details": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "code"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:00.000Z"
                      ]
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:12.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "fileName",
                    "bytes",
                    "shopSystem",
                    "state",
                    "preview",
                    "written",
                    "created",
                    "updated",
                    "unchanged",
                    "error",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Import not found",
                      "details": {
                        "resource": "Import"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.import_state`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.import_state": {
                    "summary": "commerce.import_state",
                    "value": {
                      "code": "commerce.import_state",
                      "error": "The import is importing; this step is not possible now.",
                      "details": {
                        "state": "importing"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "importId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "shopSystem": {
                    "type": "string",
                    "enum": [
                      "shopify",
                      "shopware",
                      "woocommerce"
                    ]
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/imports/{importId}/start": {
      "post": {
        "operationId": "startProductImport",
        "tags": [
          "commerce"
        ],
        "summary": "Import a read file's products into a catalog",
        "description": "Writes the read file's products into the catalog: new products are created, changed ones updated by their `externalId`, unchanged ones only counted. Products of the catalog the file does not hold stay. A catalog runs one import at a time.\n\n- **Before:** the import is `ready`; `createCatalog` makes a catalog for a new shop.\n- **Polling:** `getProductImport` until it is `done` or `failed`.\n- **Then:** `getCatalogImport` counts the catalog's products the file did not hold, and `removeMissingProducts` removes them.\n- **Retries:** starting again is safe; a `failed` import starts over and skips unchanged products.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "202": {
            "description": "The import, importing",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "catalogId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The catalog it imports into, once it was started"
                    },
                    "fileName": {
                      "type": "string",
                      "examples": [
                        "products_export.csv"
                      ]
                    },
                    "bytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file's size; 0 while the Platform still fetches it from a URL",
                      "examples": [
                        2481337
                      ]
                    },
                    "shopSystem": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "shopify",
                            "shopware",
                            "woocommerce"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The shop system whose export the file is, once it was read"
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "uploading",
                        "reading",
                        "ready",
                        "importing",
                        "done",
                        "failed"
                      ]
                    },
                    "preview": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "products": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                1240
                              ]
                            },
                            "variants": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                3712
                              ]
                            },
                            "images": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "examples": [
                                2980
                              ]
                            },
                            "titles": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "The first products' titles",
                              "examples": [
                                [
                                  "Classic hoodie",
                                  "Canvas tote"
                                ]
                              ]
                            },
                            "skipped": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "row": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  "reason": {
                                    "type": "string",
                                    "enum": [
                                      "missing_id",
                                      "missing_title",
                                      "unreadable_price",
                                      "orphan_variant",
                                      "no_readable_variant",
                                      "invalid_image_url",
                                      "invalid_product",
                                      "duplicate_id"
                                    ]
                                  },
                                  "field": {
                                    "type": "string",
                                    "enum": [
                                      "externalId",
                                      "handle",
                                      "title",
                                      "descriptionHtml",
                                      "brand",
                                      "productType",
                                      "categories",
                                      "tags",
                                      "status",
                                      "options",
                                      "attributes",
                                      "variants",
                                      "images"
                                    ]
                                  }
                                },
                                "required": [
                                  "row",
                                  "reason"
                                ]
                              },
                              "description": "The first rows the import leaves out, with their reason"
                            },
                            "skippedCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many rows the import leaves out in all",
                              "examples": [
                                2
                              ]
                            }
                          },
                          "required": [
                            "products",
                            "variants",
                            "images",
                            "titles",
                            "skipped",
                            "skippedCount"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "written": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Products stored so far while it imports",
                      "examples": [
                        600
                      ]
                    },
                    "created": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        580
                      ]
                    },
                    "updated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        12
                      ]
                    },
                    "unchanged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "examples": [
                        8
                      ]
                    },
                    "error": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "string",
                              "examples": [
                                "commerce.file_unreadable"
                              ]
                            },
                            "details": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "code"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:00.000Z"
                      ]
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "examples": [
                        "2026-11-03T10:00:12.000Z"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "fileName",
                    "bytes",
                    "shopSystem",
                    "state",
                    "preview",
                    "written",
                    "created",
                    "updated",
                    "unchanged",
                    "error",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Import not found",
                      "details": {
                        "resource": "Import"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.import_state`, `commerce.import_running`, `commerce.shop_system_mismatch`, `commerce.catalog_without_shop_system`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.import_state": {
                    "summary": "commerce.import_state",
                    "value": {
                      "code": "commerce.import_state",
                      "error": "The import is importing; this step is not possible now.",
                      "details": {
                        "state": "importing"
                      }
                    }
                  },
                  "commerce.import_running": {
                    "summary": "commerce.import_running",
                    "value": {
                      "code": "commerce.import_running",
                      "error": "Another import of this catalog is running."
                    }
                  },
                  "commerce.shop_system_mismatch": {
                    "summary": "commerce.shop_system_mismatch",
                    "value": {
                      "code": "commerce.shop_system_mismatch",
                      "error": "The catalog holds shopify products; this file is a shopware export.",
                      "details": {
                        "catalog": "shopify",
                        "file": "shopware"
                      }
                    }
                  },
                  "commerce.catalog_without_shop_system": {
                    "summary": "commerce.catalog_without_shop_system",
                    "value": {
                      "code": "commerce.catalog_without_shop_system",
                      "error": "The catalog holds products made in Ghostpull; import into a catalog of a shop."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "importId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "catalogId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  }
                },
                "required": [
                  "catalogId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/products": {
      "get": {
        "operationId": "listProducts",
        "tags": [
          "commerce"
        ],
        "summary": "List and search the account's products",
        "description": "Returns the account's products, newest first, each with its main image, number of variants and lowest price.\n\n- **Pages:** `limit` at a time (default 50, at most 100); pass `nextCursor` as `cursor` for the next page.\n- **Search:** `catalogId` keeps one catalog; `query` matches title, brand and SKU, ignoring case.\n- **Then:** `getProduct` for one product's variants and images.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "One page of products",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "examples": [
                              "019a4c2f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
                            ]
                          },
                          "catalogId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "examples": [
                              "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                            ]
                          },
                          "title": {
                            "type": "string",
                            "examples": [
                              "Classic Hoodie"
                            ]
                          },
                          "brand": {
                            "examples": [
                              "Nordfaden Studio"
                            ],
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "active",
                              "draft",
                              "archived"
                            ]
                          },
                          "imagesLoading": {
                            "type": "boolean",
                            "description": "Whether shop images of the product are still being loaded into Media",
                            "examples": [
                              false
                            ]
                          },
                          "mainImageUrl": {
                            "description": "A short-lived link to the product's first loaded image, else its first linked asset",
                            "examples": [
                              "https://media.ghostpull.example/accounts/…/front.webp"
                            ],
                            "type": "string"
                          },
                          "variantCount": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991,
                            "examples": [
                              3
                            ]
                          },
                          "priceFrom": {
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "currency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$",
                            "examples": [
                              "EUR"
                            ]
                          },
                          "generatedImages": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many images and videos Addon runs made for the product that are still in the media library; 0 when none yet",
                            "examples": [
                              2
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "catalogId",
                          "title",
                          "status",
                          "imagesLoading",
                          "variantCount",
                          "currency",
                          "generatedImages"
                        ]
                      }
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "products",
                    "nextCursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "catalogId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "description": "Only this catalog's products"
          },
          {
            "in": "query",
            "name": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Matches title, brand and SKU, ignoring case"
          },
          {
            "in": "query",
            "name": "cursor",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "description": "The previous page's `nextCursor`"
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "description": "Products per page, 50 unless set"
          }
        ],
        "x-ghostpull-permission": "products:read"
      },
      "post": {
        "operationId": "createProduct",
        "tags": [
          "commerce"
        ],
        "summary": "Make a product in a catalog without a shop system",
        "description": "Makes a product by hand: its title, optionally a description, brand, type and status, and either a SKU or options with one variant per combination of their values (each with SKU and price). Ghostpull gives the product and its variants their IDs. Answers the product as `getProduct` does.\n\n- **Before:** a catalog without a shop system (`createCatalog` without `shopSystem`); a shop's catalog takes only its imports.\n- **Then:** `linkProductAsset` adds images from the media library.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "201": {
            "description": "The new product",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
                      ]
                    },
                    "catalogId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "examples": [
                        "Classic Hoodie"
                      ]
                    },
                    "brand": {
                      "examples": [
                        "Nordfaden Studio"
                      ],
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "active",
                        "draft",
                        "archived"
                      ]
                    },
                    "imagesLoading": {
                      "type": "boolean",
                      "description": "Whether shop images of the product are still being loaded into Media",
                      "examples": [
                        false
                      ]
                    },
                    "mainImageUrl": {
                      "description": "A short-lived link to the product's first loaded image, else its first linked asset",
                      "examples": [
                        "https://media.ghostpull.example/accounts/…/front.webp"
                      ],
                      "type": "string"
                    },
                    "variantCount": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "examples": [
                        3
                      ]
                    },
                    "priceFrom": {
                      "type": "string",
                      "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                      "examples": [
                        "19.90"
                      ]
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$",
                      "examples": [
                        "EUR"
                      ]
                    },
                    "generatedImages": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many images and videos Addon runs made for the product that are still in the media library; 0 when none yet",
                      "examples": [
                        2
                      ]
                    },
                    "externalId": {
                      "type": "string",
                      "examples": [
                        "classic-hoodie"
                      ]
                    },
                    "description": {
                      "description": "Plain text; the source's HTML never reaches a client",
                      "examples": [
                        "Soft cotton hoodie.\nMachine washable."
                      ],
                      "type": "string"
                    },
                    "productType": {
                      "examples": [
                        "Hoodie"
                      ],
                      "type": "string"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "Apparel > Hoodies"
                        ]
                      ]
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "winter",
                          "unisex"
                        ]
                      ]
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "attributes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "variants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "externalId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's ID in its source, unique within its product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "title": {
                            "examples": [
                              "Classic Hoodie - S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "sku": {
                            "examples": [
                              "HOOD-S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "barcode": {
                            "description": "The GTIN, EAN, UPC or ISBN as the shop exports it; free text, neither checked nor unique",
                            "examples": [
                              "4006381333931"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "price": {
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "compareAtPrice": {
                            "description": "The higher price the variant was sold at before",
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "optionValues": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "additionalProperties": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "description": "Option name to value; empty when the source names no options",
                            "examples": [
                              {
                                "Size": "S"
                              }
                            ]
                          },
                          "attributes": {
                            "description": "What only this variant has; what all variants share stays on the product",
                            "examples": [
                              [
                                {
                                  "name": "Material",
                                  "values": [
                                    "Organic cotton"
                                  ]
                                }
                              ]
                            ],
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "examples": [
                                    "Size"
                                  ]
                                },
                                "values": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255
                                  },
                                  "examples": [
                                    [
                                      "S",
                                      "M",
                                      "L"
                                    ]
                                  ]
                                }
                              },
                              "required": [
                                "name",
                                "values"
                              ]
                            }
                          },
                          "imagePositions": {
                            "description": "The positions of the product's images that show this variant, the first its main one",
                            "examples": [
                              [
                                2
                              ]
                            ],
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 2147483647
                            }
                          }
                        },
                        "required": [
                          "externalId",
                          "optionValues"
                        ]
                      }
                    },
                    "images": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "description": "The image on the shop's server, where it was loaded from",
                            "examples": [
                              "https://cdn.shop.example/hoodie-front.jpg"
                            ]
                          },
                          "alt": {
                            "examples": [
                              "Classic hoodie, front"
                            ],
                            "type": "string"
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "1 is the product's main image",
                            "examples": [
                              1
                            ]
                          },
                          "asset": {
                            "description": "The image in Media, a kept asset; left out while it is not loaded yet or when loading failed",
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "loadError": {
                            "description": "Why the image could not be loaded into Media; it is tried again when an import sends it again",
                            "examples": [
                              "media.public_file_rejected"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "url",
                          "position"
                        ]
                      },
                      "description": "The shop's images, loaded into Media, in position order"
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "asset": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "variant": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's externalId; left out, the asset belongs to the whole product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "The order among the links of the product, or of the variant; 1 comes first",
                            "examples": [
                              1
                            ]
                          },
                          "run": {
                            "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                            "type": "object",
                            "properties": {
                              "runId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              },
                              "addonId": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "runId",
                              "addonId"
                            ]
                          }
                        },
                        "required": [
                          "asset",
                          "position"
                        ]
                      },
                      "description": "Library assets linked to the product or its variants, in position order"
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "title",
                    "status",
                    "imagesLoading",
                    "variantCount",
                    "currency",
                    "generatedImages",
                    "externalId",
                    "categories",
                    "tags",
                    "options",
                    "attributes",
                    "variants",
                    "images",
                    "assets"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Catalog not found",
                      "details": {
                        "resource": "Catalog"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.catalog_has_shop_system`, `commerce.catalog_full`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.catalog_has_shop_system": {
                    "summary": "commerce.catalog_has_shop_system",
                    "value": {
                      "code": "commerce.catalog_has_shop_system",
                      "error": "The catalog's products come from its shop; make products in a catalog without a shop system."
                    }
                  },
                  "commerce.catalog_full": {
                    "summary": "commerce.catalog_full",
                    "value": {
                      "code": "commerce.catalog_full",
                      "error": "A catalog holds at most 50000 products.",
                      "details": {
                        "max": 50000
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "catalogId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "A catalog without a shop system, from listCatalogs"
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                      "Basic T-shirt"
                    ]
                  },
                  "description": {
                    "description": "Plain text; a new line starts a paragraph",
                    "type": "string",
                    "maxLength": 8000
                  },
                  "brand": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  },
                  "productType": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  },
                  "sku": {
                    "description": "The SKU of a product without options, kept on its one variant",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  },
                  "status": {
                    "default": "active",
                    "type": "string",
                    "enum": [
                      "active",
                      "draft",
                      "archived"
                    ]
                  },
                  "options": {
                    "default": [],
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255,
                          "examples": [
                            "Size"
                          ]
                        },
                        "values": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "examples": [
                            [
                              "S",
                              "M",
                              "L"
                            ]
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "values"
                      ]
                    },
                    "description": "The names and values that tell variants apart, such as Colour and Size"
                  },
                  "variants": {
                    "default": [],
                    "maxItems": 2048,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "externalId": {
                          "description": "The variant's ID from getProduct, to keep it and its linked assets on an edit; left out for a new variant",
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "sku": {
                          "examples": [
                            "TEE-W-S"
                          ],
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "price": {
                          "type": "string",
                          "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                          "examples": [
                            "19.90"
                          ]
                        },
                        "compareAtPrice": {
                          "description": "The higher price the variant was sold at before",
                          "type": "string",
                          "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                          "examples": [
                            "19.90"
                          ]
                        },
                        "optionValues": {
                          "default": {},
                          "description": "Option name to value; one value for each option",
                          "examples": [
                            {
                              "Colour": "White",
                              "Size": "S"
                            }
                          ],
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "additionalProperties": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          }
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "Without options at most one; with options one per combination of values. Left out with no options: one variant with `sku`"
                  }
                },
                "required": [
                  "catalogId",
                  "title"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/products/{productId}": {
      "get": {
        "operationId": "getProduct",
        "tags": [
          "commerce"
        ],
        "summary": "Get a product with its variants, images and linked assets",
        "description": "Returns one product: its texts (the description as plain text), options, attributes, variants, its shop images by position (the first being its main image) and the media library assets linked to it or its variants.\n\n- **File URLs:** a shop image is loaded into Media after its import; once loaded it carries `asset`, whose `url` expires, until then only the shop's `url`, and `loadError` when it could not be loaded. An Addon's image input takes the loaded asset.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The product",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
                      ]
                    },
                    "catalogId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "examples": [
                        "Classic Hoodie"
                      ]
                    },
                    "brand": {
                      "examples": [
                        "Nordfaden Studio"
                      ],
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "active",
                        "draft",
                        "archived"
                      ]
                    },
                    "imagesLoading": {
                      "type": "boolean",
                      "description": "Whether shop images of the product are still being loaded into Media",
                      "examples": [
                        false
                      ]
                    },
                    "mainImageUrl": {
                      "description": "A short-lived link to the product's first loaded image, else its first linked asset",
                      "examples": [
                        "https://media.ghostpull.example/accounts/…/front.webp"
                      ],
                      "type": "string"
                    },
                    "variantCount": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "examples": [
                        3
                      ]
                    },
                    "priceFrom": {
                      "type": "string",
                      "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                      "examples": [
                        "19.90"
                      ]
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$",
                      "examples": [
                        "EUR"
                      ]
                    },
                    "generatedImages": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many images and videos Addon runs made for the product that are still in the media library; 0 when none yet",
                      "examples": [
                        2
                      ]
                    },
                    "externalId": {
                      "type": "string",
                      "examples": [
                        "classic-hoodie"
                      ]
                    },
                    "description": {
                      "description": "Plain text; the source's HTML never reaches a client",
                      "examples": [
                        "Soft cotton hoodie.\nMachine washable."
                      ],
                      "type": "string"
                    },
                    "productType": {
                      "examples": [
                        "Hoodie"
                      ],
                      "type": "string"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "Apparel > Hoodies"
                        ]
                      ]
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "winter",
                          "unisex"
                        ]
                      ]
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "attributes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "variants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "externalId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's ID in its source, unique within its product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "title": {
                            "examples": [
                              "Classic Hoodie - S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "sku": {
                            "examples": [
                              "HOOD-S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "barcode": {
                            "description": "The GTIN, EAN, UPC or ISBN as the shop exports it; free text, neither checked nor unique",
                            "examples": [
                              "4006381333931"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "price": {
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "compareAtPrice": {
                            "description": "The higher price the variant was sold at before",
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "optionValues": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "additionalProperties": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "description": "Option name to value; empty when the source names no options",
                            "examples": [
                              {
                                "Size": "S"
                              }
                            ]
                          },
                          "attributes": {
                            "description": "What only this variant has; what all variants share stays on the product",
                            "examples": [
                              [
                                {
                                  "name": "Material",
                                  "values": [
                                    "Organic cotton"
                                  ]
                                }
                              ]
                            ],
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "examples": [
                                    "Size"
                                  ]
                                },
                                "values": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255
                                  },
                                  "examples": [
                                    [
                                      "S",
                                      "M",
                                      "L"
                                    ]
                                  ]
                                }
                              },
                              "required": [
                                "name",
                                "values"
                              ]
                            }
                          },
                          "imagePositions": {
                            "description": "The positions of the product's images that show this variant, the first its main one",
                            "examples": [
                              [
                                2
                              ]
                            ],
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 2147483647
                            }
                          }
                        },
                        "required": [
                          "externalId",
                          "optionValues"
                        ]
                      }
                    },
                    "images": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "description": "The image on the shop's server, where it was loaded from",
                            "examples": [
                              "https://cdn.shop.example/hoodie-front.jpg"
                            ]
                          },
                          "alt": {
                            "examples": [
                              "Classic hoodie, front"
                            ],
                            "type": "string"
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "1 is the product's main image",
                            "examples": [
                              1
                            ]
                          },
                          "asset": {
                            "description": "The image in Media, a kept asset; left out while it is not loaded yet or when loading failed",
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "loadError": {
                            "description": "Why the image could not be loaded into Media; it is tried again when an import sends it again",
                            "examples": [
                              "media.public_file_rejected"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "url",
                          "position"
                        ]
                      },
                      "description": "The shop's images, loaded into Media, in position order"
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "asset": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "variant": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's externalId; left out, the asset belongs to the whole product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "The order among the links of the product, or of the variant; 1 comes first",
                            "examples": [
                              1
                            ]
                          },
                          "run": {
                            "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                            "type": "object",
                            "properties": {
                              "runId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              },
                              "addonId": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "runId",
                              "addonId"
                            ]
                          }
                        },
                        "required": [
                          "asset",
                          "position"
                        ]
                      },
                      "description": "Library assets linked to the product or its variants, in position order"
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "title",
                    "status",
                    "imagesLoading",
                    "variantCount",
                    "currency",
                    "generatedImages",
                    "externalId",
                    "categories",
                    "tags",
                    "options",
                    "attributes",
                    "variants",
                    "images",
                    "assets"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:read"
      },
      "patch": {
        "operationId": "updateProduct",
        "tags": [
          "commerce"
        ],
        "summary": "Change a product made in Ghostpull",
        "description": "Changes the fields sent and keeps the others. Options and variants are sent together and replace the product's; a variant keeps its ID, and the assets linked to it, when its `externalId` from `getProduct` is sent back. `sku` alone changes the SKU of a product without options. A shop's products change only with their imports.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "The changed product",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
                      ]
                    },
                    "catalogId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "examples": [
                        "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "examples": [
                        "Classic Hoodie"
                      ]
                    },
                    "brand": {
                      "examples": [
                        "Nordfaden Studio"
                      ],
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "active",
                        "draft",
                        "archived"
                      ]
                    },
                    "imagesLoading": {
                      "type": "boolean",
                      "description": "Whether shop images of the product are still being loaded into Media",
                      "examples": [
                        false
                      ]
                    },
                    "mainImageUrl": {
                      "description": "A short-lived link to the product's first loaded image, else its first linked asset",
                      "examples": [
                        "https://media.ghostpull.example/accounts/…/front.webp"
                      ],
                      "type": "string"
                    },
                    "variantCount": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "examples": [
                        3
                      ]
                    },
                    "priceFrom": {
                      "type": "string",
                      "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                      "examples": [
                        "19.90"
                      ]
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[A-Z]{3}$",
                      "examples": [
                        "EUR"
                      ]
                    },
                    "generatedImages": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many images and videos Addon runs made for the product that are still in the media library; 0 when none yet",
                      "examples": [
                        2
                      ]
                    },
                    "externalId": {
                      "type": "string",
                      "examples": [
                        "classic-hoodie"
                      ]
                    },
                    "description": {
                      "description": "Plain text; the source's HTML never reaches a client",
                      "examples": [
                        "Soft cotton hoodie.\nMachine washable."
                      ],
                      "type": "string"
                    },
                    "productType": {
                      "examples": [
                        "Hoodie"
                      ],
                      "type": "string"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "Apparel > Hoodies"
                        ]
                      ]
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "examples": [
                        [
                          "winter",
                          "unisex"
                        ]
                      ]
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "attributes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "examples": [
                              "Size"
                            ]
                          },
                          "values": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "examples": [
                              [
                                "S",
                                "M",
                                "L"
                              ]
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "values"
                        ]
                      }
                    },
                    "variants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "externalId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's ID in its source, unique within its product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "title": {
                            "examples": [
                              "Classic Hoodie - S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "sku": {
                            "examples": [
                              "HOOD-S"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "barcode": {
                            "description": "The GTIN, EAN, UPC or ISBN as the shop exports it; free text, neither checked nor unique",
                            "examples": [
                              "4006381333931"
                            ],
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "price": {
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "compareAtPrice": {
                            "description": "The higher price the variant was sold at before",
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "optionValues": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "additionalProperties": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            },
                            "description": "Option name to value; empty when the source names no options",
                            "examples": [
                              {
                                "Size": "S"
                              }
                            ]
                          },
                          "attributes": {
                            "description": "What only this variant has; what all variants share stays on the product",
                            "examples": [
                              [
                                {
                                  "name": "Material",
                                  "values": [
                                    "Organic cotton"
                                  ]
                                }
                              ]
                            ],
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "examples": [
                                    "Size"
                                  ]
                                },
                                "values": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255
                                  },
                                  "examples": [
                                    [
                                      "S",
                                      "M",
                                      "L"
                                    ]
                                  ]
                                }
                              },
                              "required": [
                                "name",
                                "values"
                              ]
                            }
                          },
                          "imagePositions": {
                            "description": "The positions of the product's images that show this variant, the first its main one",
                            "examples": [
                              [
                                2
                              ]
                            ],
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 2147483647
                            }
                          }
                        },
                        "required": [
                          "externalId",
                          "optionValues"
                        ]
                      }
                    },
                    "images": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "description": "The image on the shop's server, where it was loaded from",
                            "examples": [
                              "https://cdn.shop.example/hoodie-front.jpg"
                            ]
                          },
                          "alt": {
                            "examples": [
                              "Classic hoodie, front"
                            ],
                            "type": "string"
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "1 is the product's main image",
                            "examples": [
                              1
                            ]
                          },
                          "asset": {
                            "description": "The image in Media, a kept asset; left out while it is not loaded yet or when loading failed",
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "loadError": {
                            "description": "Why the image could not be loaded into Media; it is tried again when an import sends it again",
                            "examples": [
                              "media.public_file_rejected"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "url",
                          "position"
                        ]
                      },
                      "description": "The shop's images, loaded into Media, in position order"
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "asset": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The stable asset ID, shared by its versions."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The immutable version number of this asset, starting at 1."
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "library",
                                  "kept",
                                  "job"
                                ],
                                "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                              },
                              "asset": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/video"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "video/mp4",
                                          "video/webm",
                                          "video/quicktime"
                                        ]
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/3d"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "model/gltf-binary",
                                          "model/gltf+json"
                                        ]
                                      },
                                      "thumbnail": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/json"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "application/json"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/vector"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/svg+xml"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                ],
                                "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                              },
                              "editable": {
                                "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                                "type": "boolean",
                                "const": true
                              },
                              "composition": {
                                "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "number",
                                    "const": 1
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "height": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 8192
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 3600
                                  },
                                  "fps": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 60
                                  },
                                  "loop": {
                                    "type": "boolean"
                                  },
                                  "background": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "layers": {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "image"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/image"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "image/png",
                                                    "image/jpeg",
                                                    "image/gif",
                                                    "image/webp",
                                                    "image/svg+xml"
                                                  ]
                                                },
                                                "srcSet": {
                                                  "minItems": 1,
                                                  "type": "array",
                                                  "items": {
                                                    "type": "object",
                                                    "properties": {
                                                      "url": {
                                                        "type": "string",
                                                        "minLength": 1
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991
                                                      }
                                                    },
                                                    "required": [
                                                      "url",
                                                      "width"
                                                    ]
                                                  }
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "cutoutOf": {
                                              "type": "string",
                                              "enum": [
                                                "person",
                                                "product"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "video"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/video"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "height": {
                                                  "examples": [
                                                    1200
                                                  ],
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "video/mp4",
                                                    "video/webm",
                                                    "video/quicktime"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                },
                                                "thumbnail": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "width": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    },
                                                    "height": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991
                                                    }
                                                  },
                                                  "required": [
                                                    "url"
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "fit": {
                                              "type": "string",
                                              "enum": [
                                                "contain",
                                                "cover"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "trim": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "loop": {
                                              "type": "boolean"
                                            },
                                            "volume": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "audio"
                                            },
                                            "asset": {
                                              "type": "object",
                                              "properties": {
                                                "type": {
                                                  "type": "string",
                                                  "const": "asset/audio"
                                                },
                                                "url": {
                                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                  "examples": [
                                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "key": {
                                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                  "examples": [
                                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                  ],
                                                  "type": "string",
                                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                },
                                                "name": {
                                                  "description": "The display name, such as the original file name.",
                                                  "examples": [
                                                    "shoe.png"
                                                  ],
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "mediaType": {
                                                  "type": "string",
                                                  "enum": [
                                                    "audio/mpeg",
                                                    "audio/wav",
                                                    "audio/ogg",
                                                    "audio/aac",
                                                    "audio/mp4"
                                                  ]
                                                },
                                                "duration": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0
                                                }
                                              },
                                              "required": [
                                                "type"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "volume"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "asset"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "text"
                                            },
                                            "text": {
                                              "type": "string"
                                            },
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "fontSize": {
                                              "type": "number",
                                              "exclusiveMinimum": 0,
                                              "maximum": 1
                                            },
                                            "lineHeight": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "letterSpacing": {
                                              "type": "number",
                                              "minimum": -0.2,
                                              "maximum": 1
                                            },
                                            "textTransform": {
                                              "type": "string",
                                              "enum": [
                                                "none",
                                                "uppercase"
                                              ]
                                            },
                                            "lineBreaks": {
                                              "type": "string",
                                              "const": "explicit"
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "align": {
                                              "type": "string",
                                              "enum": [
                                                "left",
                                                "center",
                                                "right"
                                              ]
                                            },
                                            "spans": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "fontFamily": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "fontWeight": {
                                                    "type": "integer",
                                                    "minimum": 100,
                                                    "maximum": 900
                                                  },
                                                  "fontStyle": {
                                                    "type": "string",
                                                    "enum": [
                                                      "normal",
                                                      "italic"
                                                    ]
                                                  },
                                                  "color": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "start",
                                                  "end"
                                                ]
                                              }
                                            },
                                            "path": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "arc"
                                                    },
                                                    "center": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "radius": {
                                                      "type": "number",
                                                      "exclusiveMinimum": 0
                                                    },
                                                    "startAngle": {
                                                      "type": "number"
                                                    },
                                                    "sweepAngle": {
                                                      "type": "number",
                                                      "minimum": -360,
                                                      "maximum": 360
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "radius",
                                                    "sweepAngle"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "bezier"
                                                    },
                                                    "start": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "segments": {
                                                      "minItems": 1,
                                                      "maxItems": 64,
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "control1": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "control2": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          },
                                                          "end": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "control1",
                                                          "control2",
                                                          "end"
                                                        ]
                                                      }
                                                    },
                                                    "fit": {
                                                      "type": "string",
                                                      "enum": [
                                                        "shrink",
                                                        "clip"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "start",
                                                    "segments"
                                                  ]
                                                }
                                              ]
                                            },
                                            "units": {
                                              "type": "object",
                                              "properties": {
                                                "by": {
                                                  "type": "string",
                                                  "enum": [
                                                    "character",
                                                    "word",
                                                    "line"
                                                  ]
                                                },
                                                "stagger": {
                                                  "type": "number",
                                                  "minimum": 0
                                                },
                                                "reverse": {
                                                  "type": "boolean"
                                                },
                                                "animate": {
                                                  "type": "object",
                                                  "propertyNames": {
                                                    "type": "string",
                                                    "enum": [
                                                      "x",
                                                      "y",
                                                      "rotation",
                                                      "opacity",
                                                      "scale"
                                                    ]
                                                  },
                                                  "additionalProperties": {
                                                    "minItems": 1,
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "time": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "value": {
                                                          "type": "number"
                                                        },
                                                        "easing": {
                                                          "type": "string",
                                                          "enum": [
                                                            "linear",
                                                            "ease-in",
                                                            "ease-out",
                                                            "ease-in-out",
                                                            "step"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "time",
                                                        "value"
                                                      ]
                                                    }
                                                  }
                                                }
                                              },
                                              "required": [
                                                "by",
                                                "stagger",
                                                "animate"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale",
                                                  "fontSize"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "text"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "shape"
                                            },
                                            "shape": {
                                              "type": "string",
                                              "enum": [
                                                "rectangle",
                                                "ellipse",
                                                "path"
                                              ]
                                            },
                                            "points": {
                                              "minItems": 3,
                                              "maxItems": 64,
                                              "type": "array",
                                              "items": {
                                                "type": "array",
                                                "prefixItems": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  {
                                                    "type": "number",
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                ],
                                                "items": false,
                                                "minItems": 2,
                                                "maxItems": 2
                                              }
                                            },
                                            "fill": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "stroke": {
                                              "type": "object",
                                              "properties": {
                                                "color": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "number",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 0.05
                                                }
                                              },
                                              "required": [
                                                "color",
                                                "width"
                                              ]
                                            },
                                            "radius": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind"
                                          ]
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "role": {
                                              "type": "string",
                                              "enum": [
                                                "background",
                                                "subject",
                                                "logo",
                                                "headline",
                                                "subline",
                                                "cta",
                                                "label",
                                                "container",
                                                "pointer",
                                                "area"
                                              ]
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "hidden": {
                                              "type": "boolean"
                                            },
                                            "start": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "duration": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "x": {
                                              "type": "number"
                                            },
                                            "y": {
                                              "type": "number"
                                            },
                                            "width": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "height": {
                                              "type": "number",
                                              "exclusiveMinimum": 0
                                            },
                                            "rotation": {
                                              "type": "number"
                                            },
                                            "opacity": {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "scale": {
                                              "type": "number",
                                              "minimum": 0
                                            },
                                            "kind": {
                                              "type": "string",
                                              "const": "three"
                                            },
                                            "scene": {
                                              "type": "object",
                                              "properties": {
                                                "camera": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "perspective"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "fov": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0,
                                                          "exclusiveMaximum": 180
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "orthographic"
                                                        },
                                                        "position": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "target": {
                                                          "type": "object",
                                                          "properties": {
                                                            "x": {
                                                              "type": "number"
                                                            },
                                                            "y": {
                                                              "type": "number"
                                                            },
                                                            "z": {
                                                              "type": "number"
                                                            }
                                                          },
                                                          "required": [
                                                            "x",
                                                            "y",
                                                            "z"
                                                          ]
                                                        },
                                                        "near": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "far": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        },
                                                        "height": {
                                                          "type": "number",
                                                          "exclusiveMinimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "kind"
                                                      ]
                                                    }
                                                  ]
                                                },
                                                "nodes": {
                                                  "type": "array",
                                                  "items": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "group"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "mesh"
                                                          },
                                                          "geometry": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "box"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "depth": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height",
                                                                  "depth"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sphere"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "plane"
                                                                  },
                                                                  "width": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "width",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "cylinder"
                                                                  },
                                                                  "radiusTop": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "radiusBottom": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "height": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radiusTop",
                                                                  "radiusBottom",
                                                                  "height"
                                                                ]
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "torus"
                                                                  },
                                                                  "radius": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  },
                                                                  "tube": {
                                                                    "type": "number",
                                                                    "exclusiveMinimum": 0
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "radius",
                                                                  "tube"
                                                                ]
                                                              }
                                                            ]
                                                          },
                                                          "material": {
                                                            "type": "object",
                                                            "properties": {
                                                              "color": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "opacity": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "metalness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "roughness": {
                                                                "type": "number",
                                                                "minimum": 0,
                                                                "maximum": 1
                                                              },
                                                              "doubleSided": {
                                                                "type": "boolean"
                                                              }
                                                            }
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "geometry"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "model"
                                                          },
                                                          "asset": {
                                                            "type": "object",
                                                            "properties": {
                                                              "type": {
                                                                "type": "string",
                                                                "const": "asset/3d"
                                                              },
                                                              "url": {
                                                                "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                                "examples": [
                                                                  "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "key": {
                                                                "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                                "examples": [
                                                                  "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                                ],
                                                                "type": "string",
                                                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                              },
                                                              "name": {
                                                                "description": "The display name, such as the original file name.",
                                                                "examples": [
                                                                  "shoe.png"
                                                                ],
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "mediaType": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "model/gltf-binary",
                                                                  "model/gltf+json"
                                                                ]
                                                              },
                                                              "thumbnail": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "url": {
                                                                    "type": "string",
                                                                    "minLength": 1
                                                                  },
                                                                  "width": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  },
                                                                  "height": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991
                                                                  }
                                                                },
                                                                "required": [
                                                                  "url"
                                                                ]
                                                              }
                                                            },
                                                            "required": [
                                                              "type"
                                                            ]
                                                          },
                                                          "clip": {
                                                            "type": "object",
                                                            "properties": {
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1
                                                              },
                                                              "offset": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "speed": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "loop": {
                                                                "type": "boolean"
                                                              }
                                                            },
                                                            "required": [
                                                              "name"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind",
                                                          "asset"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "ambient-light"
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "directional-light"
                                                          },
                                                          "target": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "id": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "name": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "parentId": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "visible": {
                                                            "type": "boolean"
                                                          },
                                                          "position": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "rotation": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number"
                                                              },
                                                              "y": {
                                                                "type": "number"
                                                              },
                                                              "z": {
                                                                "type": "number"
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "scale": {
                                                            "type": "object",
                                                            "properties": {
                                                              "x": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "y": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              },
                                                              "z": {
                                                                "type": "number",
                                                                "minimum": 0
                                                              }
                                                            },
                                                            "required": [
                                                              "x",
                                                              "y",
                                                              "z"
                                                            ]
                                                          },
                                                          "animate": {
                                                            "type": "object",
                                                            "propertyNames": {
                                                              "type": "string",
                                                              "enum": [
                                                                "position.x",
                                                                "position.y",
                                                                "position.z",
                                                                "rotation.x",
                                                                "rotation.y",
                                                                "rotation.z",
                                                                "scale.x",
                                                                "scale.y",
                                                                "scale.z"
                                                              ]
                                                            },
                                                            "additionalProperties": {
                                                              "minItems": 1,
                                                              "type": "array",
                                                              "items": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "time": {
                                                                    "type": "number",
                                                                    "minimum": 0
                                                                  },
                                                                  "value": {
                                                                    "type": "number"
                                                                  },
                                                                  "easing": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "linear",
                                                                      "ease-in",
                                                                      "ease-out",
                                                                      "ease-in-out",
                                                                      "step"
                                                                    ]
                                                                  }
                                                                },
                                                                "required": [
                                                                  "time",
                                                                  "value"
                                                                ]
                                                              }
                                                            }
                                                          },
                                                          "color": {
                                                            "type": "string",
                                                            "minLength": 1
                                                          },
                                                          "intensity": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "point-light"
                                                          },
                                                          "distance": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          },
                                                          "decay": {
                                                            "type": "number",
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "id",
                                                          "kind"
                                                        ]
                                                      }
                                                    ]
                                                  }
                                                },
                                                "background": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "exposure": {
                                                  "type": "number",
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "nodes"
                                              ]
                                            },
                                            "animate": {
                                              "type": "object",
                                              "propertyNames": {
                                                "type": "string",
                                                "enum": [
                                                  "x",
                                                  "y",
                                                  "width",
                                                  "height",
                                                  "rotation",
                                                  "opacity",
                                                  "scale"
                                                ]
                                              },
                                              "additionalProperties": {
                                                "minItems": 1,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "time": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "value": {
                                                      "type": "number"
                                                    },
                                                    "easing": {
                                                      "type": "string",
                                                      "enum": [
                                                        "linear",
                                                        "ease-in",
                                                        "ease-out",
                                                        "ease-in-out",
                                                        "step"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "time",
                                                    "value"
                                                  ]
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "kind",
                                            "scene"
                                          ]
                                        }
                                      ]
                                    }
                                  },
                                  "fonts": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "family": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "weight": {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 900
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "normal",
                                            "italic"
                                          ]
                                        },
                                        "file": {
                                          "type": "string",
                                          "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                        },
                                        "asset": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/font"
                                            },
                                            "key": {
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "font/ttf",
                                                "font/otf"
                                              ]
                                            },
                                            "url": {
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type",
                                            "key",
                                            "mediaType"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "family",
                                        "weight",
                                        "style"
                                      ]
                                    }
                                  },
                                  "masks": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "subject": {
                                          "type": "string",
                                          "enum": [
                                            "product",
                                            "person",
                                            "object"
                                          ]
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 200
                                        },
                                        "src": {
                                          "type": "object",
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "const": "asset/image"
                                            },
                                            "url": {
                                              "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                              "examples": [
                                                "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "key": {
                                              "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                              "examples": [
                                                "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                              ],
                                              "type": "string",
                                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                            },
                                            "name": {
                                              "description": "The display name, such as the original file name.",
                                              "examples": [
                                                "shoe.png"
                                              ],
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "examples": [
                                                1200
                                              ],
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "mediaType": {
                                              "type": "string",
                                              "enum": [
                                                "image/png",
                                                "image/jpeg",
                                                "image/gif",
                                                "image/webp",
                                                "image/svg+xml"
                                              ]
                                            },
                                            "srcSet": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "minLength": 1
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "width"
                                                ]
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "subject",
                                        "label",
                                        "src"
                                      ]
                                    }
                                  },
                                  "src": {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "version",
                                  "width",
                                  "height",
                                  "duration",
                                  "layers"
                                ],
                                "x-ghostpull-asset": "composition"
                              }
                            },
                            "required": [
                              "id",
                              "version",
                              "visibility",
                              "asset"
                            ]
                          },
                          "variant": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The variant's externalId; left out, the asset belongs to the whole product",
                            "examples": [
                              "HOOD-S"
                            ]
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647,
                            "description": "The order among the links of the product, or of the variant; 1 comes first",
                            "examples": [
                              1
                            ]
                          },
                          "run": {
                            "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                            "type": "object",
                            "properties": {
                              "runId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              },
                              "addonId": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "runId",
                              "addonId"
                            ]
                          }
                        },
                        "required": [
                          "asset",
                          "position"
                        ]
                      },
                      "description": "Library assets linked to the product or its variants, in position order"
                    }
                  },
                  "required": [
                    "id",
                    "catalogId",
                    "title",
                    "status",
                    "imagesLoading",
                    "variantCount",
                    "currency",
                    "generatedImages",
                    "externalId",
                    "categories",
                    "tags",
                    "options",
                    "attributes",
                    "variants",
                    "images",
                    "assets"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `commerce.sku_needs_variant`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.sku_needs_variant": {
                    "summary": "commerce.sku_needs_variant",
                    "value": {
                      "code": "commerce.sku_needs_variant",
                      "error": "The product has options; give each variant its SKU."
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.catalog_has_shop_system`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.catalog_has_shop_system": {
                    "summary": "commerce.catalog_has_shop_system",
                    "value": {
                      "code": "commerce.catalog_has_shop_system",
                      "error": "The catalog's products come from its shop; make products in a catalog without a shop system."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "examples": [
                      "Basic T-shirt"
                    ]
                  },
                  "description": {
                    "description": "Plain text; a new line starts a paragraph",
                    "type": "string",
                    "maxLength": 8000
                  },
                  "brand": {
                    "description": "The brand; empty clears it",
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255
                      },
                      {
                        "type": "string",
                        "const": ""
                      }
                    ]
                  },
                  "productType": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  },
                  "sku": {
                    "description": "The SKU of a product without options, kept on its one variant; empty clears it",
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255
                      },
                      {
                        "type": "string",
                        "const": ""
                      }
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "active",
                      "draft",
                      "archived"
                    ]
                  },
                  "options": {
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255,
                          "examples": [
                            "Size"
                          ]
                        },
                        "values": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "examples": [
                            [
                              "S",
                              "M",
                              "L"
                            ]
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "values"
                      ]
                    },
                    "description": "The names and values that tell variants apart, such as Colour and Size"
                  },
                  "variants": {
                    "maxItems": 2048,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "externalId": {
                          "description": "The variant's ID from getProduct, to keep it and its linked assets on an edit; left out for a new variant",
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "sku": {
                          "examples": [
                            "TEE-W-S"
                          ],
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255
                        },
                        "price": {
                          "type": "string",
                          "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                          "examples": [
                            "19.90"
                          ]
                        },
                        "compareAtPrice": {
                          "description": "The higher price the variant was sold at before",
                          "type": "string",
                          "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                          "examples": [
                            "19.90"
                          ]
                        },
                        "optionValues": {
                          "default": {},
                          "description": "Option name to value; one value for each option",
                          "examples": [
                            {
                              "Colour": "White",
                              "Size": "S"
                            }
                          ],
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          "additionalProperties": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          }
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "Without options at most one; with options one per combination of values. Left out with no options: one variant with `sku`"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      },
      "delete": {
        "operationId": "deleteProduct",
        "tags": [
          "commerce"
        ],
        "summary": "Delete a product",
        "description": "Deletes the product with its variants and images. A later import of its catalog brings it back if the file still has it.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "204": {
            "description": "Deleted"
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/products/{productId}/assets": {
      "post": {
        "operationId": "linkProductAsset",
        "tags": [
          "commerce"
        ],
        "summary": "Link a library asset to a product or one of its variants",
        "description": "Links an image or video of the media library to the product, or with `variant` to one of its variants, after the links it has; a product links at most 250 assets. The asset stays in the library; a product shows its shop images and its linked assets.\n\n- **Before:** the asset is in the library (`listMediaAssets`, or uploaded with `startMediaUpload` and `completeMediaUpload`).\n- **Retries:** linking the same asset to the same product or variant again answers the existing link with 200.\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "Already linked",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The stable asset ID, shared by its versions."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The immutable version number of this asset, starting at 1."
                        },
                        "visibility": {
                          "type": "string",
                          "enum": [
                            "library",
                            "kept",
                            "job"
                          ],
                          "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                        },
                        "asset": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/image"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/png",
                                    "image/jpeg",
                                    "image/gif",
                                    "image/webp",
                                    "image/svg+xml"
                                  ]
                                },
                                "srcSet": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url",
                                      "width"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/video"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "video/mp4",
                                    "video/webm",
                                    "video/quicktime"
                                  ]
                                },
                                "duration": {
                                  "type": "number",
                                  "exclusiveMinimum": 0
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/3d"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "model/gltf-binary",
                                    "model/gltf+json"
                                  ]
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/json"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "application/json"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/vector"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/svg+xml"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/font"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "font/ttf",
                                    "font/otf"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            }
                          ],
                          "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                        },
                        "editable": {
                          "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                          "type": "boolean",
                          "const": true
                        },
                        "composition": {
                          "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                          "type": "object",
                          "properties": {
                            "version": {
                              "type": "number",
                              "const": 1
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "height": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "duration": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 3600
                            },
                            "fps": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 60
                            },
                            "loop": {
                              "type": "boolean"
                            },
                            "background": {
                              "type": "string",
                              "minLength": 1
                            },
                            "layers": {
                              "type": "array",
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "image"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "cutoutOf": {
                                        "type": "string",
                                        "enum": [
                                          "person",
                                          "product"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "video"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "audio"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/audio"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "audio/mpeg",
                                              "audio/wav",
                                              "audio/ogg",
                                              "audio/aac",
                                              "audio/mp4"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "text"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "fontFamily": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "fontWeight": {
                                        "type": "integer",
                                        "minimum": 100,
                                        "maximum": 900
                                      },
                                      "fontStyle": {
                                        "type": "string",
                                        "enum": [
                                          "normal",
                                          "italic"
                                        ]
                                      },
                                      "fontSize": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 1
                                      },
                                      "lineHeight": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "letterSpacing": {
                                        "type": "number",
                                        "minimum": -0.2,
                                        "maximum": 1
                                      },
                                      "textTransform": {
                                        "type": "string",
                                        "enum": [
                                          "none",
                                          "uppercase"
                                        ]
                                      },
                                      "lineBreaks": {
                                        "type": "string",
                                        "const": "explicit"
                                      },
                                      "color": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "align": {
                                        "type": "string",
                                        "enum": [
                                          "left",
                                          "center",
                                          "right"
                                        ]
                                      },
                                      "spans": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "start": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "end": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "start",
                                            "end"
                                          ]
                                        }
                                      },
                                      "path": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "arc"
                                              },
                                              "center": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "radius": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "startAngle": {
                                                "type": "number"
                                              },
                                              "sweepAngle": {
                                                "type": "number",
                                                "minimum": -360,
                                                "maximum": 360
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "radius",
                                              "sweepAngle"
                                            ]
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "bezier"
                                              },
                                              "start": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "segments": {
                                                "minItems": 1,
                                                "maxItems": 64,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "control1": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "control2": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "end": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "control1",
                                                    "control2",
                                                    "end"
                                                  ]
                                                }
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "start",
                                              "segments"
                                            ]
                                          }
                                        ]
                                      },
                                      "units": {
                                        "type": "object",
                                        "properties": {
                                          "by": {
                                            "type": "string",
                                            "enum": [
                                              "character",
                                              "word",
                                              "line"
                                            ]
                                          },
                                          "stagger": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "reverse": {
                                            "type": "boolean"
                                          },
                                          "animate": {
                                            "type": "object",
                                            "propertyNames": {
                                              "type": "string",
                                              "enum": [
                                                "x",
                                                "y",
                                                "rotation",
                                                "opacity",
                                                "scale"
                                              ]
                                            },
                                            "additionalProperties": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "time": {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  "value": {
                                                    "type": "number"
                                                  },
                                                  "easing": {
                                                    "type": "string",
                                                    "enum": [
                                                      "linear",
                                                      "ease-in",
                                                      "ease-out",
                                                      "ease-in-out",
                                                      "step"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "time",
                                                  "value"
                                                ]
                                              }
                                            }
                                          }
                                        },
                                        "required": [
                                          "by",
                                          "stagger",
                                          "animate"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "fontSize"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "text"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "shape"
                                      },
                                      "shape": {
                                        "type": "string",
                                        "enum": [
                                          "rectangle",
                                          "ellipse",
                                          "path"
                                        ]
                                      },
                                      "points": {
                                        "minItems": 3,
                                        "maxItems": 64,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "prefixItems": [
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            }
                                          ],
                                          "items": false,
                                          "minItems": 2,
                                          "maxItems": 2
                                        }
                                      },
                                      "fill": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "stroke": {
                                        "type": "object",
                                        "properties": {
                                          "color": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "number",
                                            "exclusiveMinimum": 0,
                                            "maximum": 0.05
                                          }
                                        },
                                        "required": [
                                          "color",
                                          "width"
                                        ]
                                      },
                                      "radius": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "three"
                                      },
                                      "scene": {
                                        "type": "object",
                                        "properties": {
                                          "camera": {
                                            "oneOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "perspective"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "fov": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0,
                                                    "exclusiveMaximum": 180
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "orthographic"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "height": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              }
                                            ]
                                          },
                                          "nodes": {
                                            "type": "array",
                                            "items": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "group"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "mesh"
                                                    },
                                                    "geometry": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "box"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "depth": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height",
                                                            "depth"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sphere"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "plane"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "cylinder"
                                                            },
                                                            "radiusTop": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "radiusBottom": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radiusTop",
                                                            "radiusBottom",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "torus"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "tube": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius",
                                                            "tube"
                                                          ]
                                                        }
                                                      ]
                                                    },
                                                    "material": {
                                                      "type": "object",
                                                      "properties": {
                                                        "color": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "opacity": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "metalness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "roughness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "doubleSided": {
                                                          "type": "boolean"
                                                        }
                                                      }
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "geometry"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "model"
                                                    },
                                                    "asset": {
                                                      "type": "object",
                                                      "properties": {
                                                        "type": {
                                                          "type": "string",
                                                          "const": "asset/3d"
                                                        },
                                                        "url": {
                                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                          "examples": [
                                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "key": {
                                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                          "examples": [
                                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                          ],
                                                          "type": "string",
                                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                        },
                                                        "name": {
                                                          "description": "The display name, such as the original file name.",
                                                          "examples": [
                                                            "shoe.png"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "mediaType": {
                                                          "type": "string",
                                                          "enum": [
                                                            "model/gltf-binary",
                                                            "model/gltf+json"
                                                          ]
                                                        },
                                                        "thumbnail": {
                                                          "type": "object",
                                                          "properties": {
                                                            "url": {
                                                              "type": "string",
                                                              "minLength": 1
                                                            },
                                                            "width": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            },
                                                            "height": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            }
                                                          },
                                                          "required": [
                                                            "url"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "type"
                                                      ]
                                                    },
                                                    "clip": {
                                                      "type": "object",
                                                      "properties": {
                                                        "name": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "offset": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "speed": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "loop": {
                                                          "type": "boolean"
                                                        }
                                                      },
                                                      "required": [
                                                        "name"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "asset"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "ambient-light"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "directional-light"
                                                    },
                                                    "target": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "point-light"
                                                    },
                                                    "distance": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "decay": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                }
                                              ]
                                            }
                                          },
                                          "background": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "exposure": {
                                            "type": "number",
                                            "minimum": 0
                                          }
                                        },
                                        "required": [
                                          "nodes"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "scene"
                                    ]
                                  }
                                ]
                              }
                            },
                            "fonts": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "family": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "weight": {
                                    "type": "integer",
                                    "minimum": 100,
                                    "maximum": 900
                                  },
                                  "style": {
                                    "type": "string",
                                    "enum": [
                                      "normal",
                                      "italic"
                                    ]
                                  },
                                  "file": {
                                    "type": "string",
                                    "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "key": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      },
                                      "url": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "key",
                                      "mediaType"
                                    ]
                                  }
                                },
                                "required": [
                                  "family",
                                  "weight",
                                  "style"
                                ]
                              }
                            },
                            "masks": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "subject": {
                                    "type": "string",
                                    "enum": [
                                      "product",
                                      "person",
                                      "object"
                                    ]
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200
                                  },
                                  "src": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                },
                                "required": [
                                  "subject",
                                  "label",
                                  "src"
                                ]
                              }
                            },
                            "src": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/image"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "image/png",
                                        "image/jpeg",
                                        "image/gif",
                                        "image/webp",
                                        "image/svg+xml"
                                      ]
                                    },
                                    "srcSet": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url",
                                          "width"
                                        ]
                                      }
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/video"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "video/mp4",
                                        "video/webm",
                                        "video/quicktime"
                                      ]
                                    },
                                    "duration": {
                                      "type": "number",
                                      "exclusiveMinimum": 0
                                    },
                                    "thumbnail": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                }
                              ]
                            }
                          },
                          "required": [
                            "version",
                            "width",
                            "height",
                            "duration",
                            "layers"
                          ],
                          "x-ghostpull-asset": "composition"
                        }
                      },
                      "required": [
                        "id",
                        "version",
                        "visibility",
                        "asset"
                      ]
                    },
                    "variant": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255,
                      "description": "The variant's externalId; left out, the asset belongs to the whole product",
                      "examples": [
                        "HOOD-S"
                      ]
                    },
                    "position": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 2147483647,
                      "description": "The order among the links of the product, or of the variant; 1 comes first",
                      "examples": [
                        1
                      ]
                    },
                    "run": {
                      "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                      "type": "object",
                      "properties": {
                        "runId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        "addonId": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "runId",
                        "addonId"
                      ]
                    }
                  },
                  "required": [
                    "asset",
                    "position"
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Linked",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The stable asset ID, shared by its versions."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The immutable version number of this asset, starting at 1."
                        },
                        "visibility": {
                          "type": "string",
                          "enum": [
                            "library",
                            "kept",
                            "job"
                          ],
                          "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                        },
                        "asset": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/image"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/png",
                                    "image/jpeg",
                                    "image/gif",
                                    "image/webp",
                                    "image/svg+xml"
                                  ]
                                },
                                "srcSet": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url",
                                      "width"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/video"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "video/mp4",
                                    "video/webm",
                                    "video/quicktime"
                                  ]
                                },
                                "duration": {
                                  "type": "number",
                                  "exclusiveMinimum": 0
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/3d"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "model/gltf-binary",
                                    "model/gltf+json"
                                  ]
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/json"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "application/json"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/vector"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/svg+xml"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/font"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "font/ttf",
                                    "font/otf"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            }
                          ],
                          "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                        },
                        "editable": {
                          "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                          "type": "boolean",
                          "const": true
                        },
                        "composition": {
                          "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                          "type": "object",
                          "properties": {
                            "version": {
                              "type": "number",
                              "const": 1
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "height": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "duration": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 3600
                            },
                            "fps": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 60
                            },
                            "loop": {
                              "type": "boolean"
                            },
                            "background": {
                              "type": "string",
                              "minLength": 1
                            },
                            "layers": {
                              "type": "array",
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "image"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "cutoutOf": {
                                        "type": "string",
                                        "enum": [
                                          "person",
                                          "product"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "video"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "audio"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/audio"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "audio/mpeg",
                                              "audio/wav",
                                              "audio/ogg",
                                              "audio/aac",
                                              "audio/mp4"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "text"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "fontFamily": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "fontWeight": {
                                        "type": "integer",
                                        "minimum": 100,
                                        "maximum": 900
                                      },
                                      "fontStyle": {
                                        "type": "string",
                                        "enum": [
                                          "normal",
                                          "italic"
                                        ]
                                      },
                                      "fontSize": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 1
                                      },
                                      "lineHeight": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "letterSpacing": {
                                        "type": "number",
                                        "minimum": -0.2,
                                        "maximum": 1
                                      },
                                      "textTransform": {
                                        "type": "string",
                                        "enum": [
                                          "none",
                                          "uppercase"
                                        ]
                                      },
                                      "lineBreaks": {
                                        "type": "string",
                                        "const": "explicit"
                                      },
                                      "color": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "align": {
                                        "type": "string",
                                        "enum": [
                                          "left",
                                          "center",
                                          "right"
                                        ]
                                      },
                                      "spans": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "start": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "end": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "start",
                                            "end"
                                          ]
                                        }
                                      },
                                      "path": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "arc"
                                              },
                                              "center": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "radius": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "startAngle": {
                                                "type": "number"
                                              },
                                              "sweepAngle": {
                                                "type": "number",
                                                "minimum": -360,
                                                "maximum": 360
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "radius",
                                              "sweepAngle"
                                            ]
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "bezier"
                                              },
                                              "start": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "segments": {
                                                "minItems": 1,
                                                "maxItems": 64,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "control1": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "control2": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "end": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "control1",
                                                    "control2",
                                                    "end"
                                                  ]
                                                }
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "start",
                                              "segments"
                                            ]
                                          }
                                        ]
                                      },
                                      "units": {
                                        "type": "object",
                                        "properties": {
                                          "by": {
                                            "type": "string",
                                            "enum": [
                                              "character",
                                              "word",
                                              "line"
                                            ]
                                          },
                                          "stagger": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "reverse": {
                                            "type": "boolean"
                                          },
                                          "animate": {
                                            "type": "object",
                                            "propertyNames": {
                                              "type": "string",
                                              "enum": [
                                                "x",
                                                "y",
                                                "rotation",
                                                "opacity",
                                                "scale"
                                              ]
                                            },
                                            "additionalProperties": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "time": {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  "value": {
                                                    "type": "number"
                                                  },
                                                  "easing": {
                                                    "type": "string",
                                                    "enum": [
                                                      "linear",
                                                      "ease-in",
                                                      "ease-out",
                                                      "ease-in-out",
                                                      "step"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "time",
                                                  "value"
                                                ]
                                              }
                                            }
                                          }
                                        },
                                        "required": [
                                          "by",
                                          "stagger",
                                          "animate"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "fontSize"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "text"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "shape"
                                      },
                                      "shape": {
                                        "type": "string",
                                        "enum": [
                                          "rectangle",
                                          "ellipse",
                                          "path"
                                        ]
                                      },
                                      "points": {
                                        "minItems": 3,
                                        "maxItems": 64,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "prefixItems": [
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            }
                                          ],
                                          "items": false,
                                          "minItems": 2,
                                          "maxItems": 2
                                        }
                                      },
                                      "fill": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "stroke": {
                                        "type": "object",
                                        "properties": {
                                          "color": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "number",
                                            "exclusiveMinimum": 0,
                                            "maximum": 0.05
                                          }
                                        },
                                        "required": [
                                          "color",
                                          "width"
                                        ]
                                      },
                                      "radius": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "three"
                                      },
                                      "scene": {
                                        "type": "object",
                                        "properties": {
                                          "camera": {
                                            "oneOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "perspective"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "fov": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0,
                                                    "exclusiveMaximum": 180
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "orthographic"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "height": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              }
                                            ]
                                          },
                                          "nodes": {
                                            "type": "array",
                                            "items": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "group"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "mesh"
                                                    },
                                                    "geometry": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "box"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "depth": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height",
                                                            "depth"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sphere"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "plane"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "cylinder"
                                                            },
                                                            "radiusTop": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "radiusBottom": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radiusTop",
                                                            "radiusBottom",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "torus"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "tube": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius",
                                                            "tube"
                                                          ]
                                                        }
                                                      ]
                                                    },
                                                    "material": {
                                                      "type": "object",
                                                      "properties": {
                                                        "color": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "opacity": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "metalness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "roughness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "doubleSided": {
                                                          "type": "boolean"
                                                        }
                                                      }
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "geometry"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "model"
                                                    },
                                                    "asset": {
                                                      "type": "object",
                                                      "properties": {
                                                        "type": {
                                                          "type": "string",
                                                          "const": "asset/3d"
                                                        },
                                                        "url": {
                                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                          "examples": [
                                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "key": {
                                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                          "examples": [
                                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                          ],
                                                          "type": "string",
                                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                        },
                                                        "name": {
                                                          "description": "The display name, such as the original file name.",
                                                          "examples": [
                                                            "shoe.png"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "mediaType": {
                                                          "type": "string",
                                                          "enum": [
                                                            "model/gltf-binary",
                                                            "model/gltf+json"
                                                          ]
                                                        },
                                                        "thumbnail": {
                                                          "type": "object",
                                                          "properties": {
                                                            "url": {
                                                              "type": "string",
                                                              "minLength": 1
                                                            },
                                                            "width": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            },
                                                            "height": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            }
                                                          },
                                                          "required": [
                                                            "url"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "type"
                                                      ]
                                                    },
                                                    "clip": {
                                                      "type": "object",
                                                      "properties": {
                                                        "name": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "offset": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "speed": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "loop": {
                                                          "type": "boolean"
                                                        }
                                                      },
                                                      "required": [
                                                        "name"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "asset"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "ambient-light"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "directional-light"
                                                    },
                                                    "target": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "point-light"
                                                    },
                                                    "distance": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "decay": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                }
                                              ]
                                            }
                                          },
                                          "background": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "exposure": {
                                            "type": "number",
                                            "minimum": 0
                                          }
                                        },
                                        "required": [
                                          "nodes"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "scene"
                                    ]
                                  }
                                ]
                              }
                            },
                            "fonts": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "family": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "weight": {
                                    "type": "integer",
                                    "minimum": 100,
                                    "maximum": 900
                                  },
                                  "style": {
                                    "type": "string",
                                    "enum": [
                                      "normal",
                                      "italic"
                                    ]
                                  },
                                  "file": {
                                    "type": "string",
                                    "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "key": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      },
                                      "url": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "key",
                                      "mediaType"
                                    ]
                                  }
                                },
                                "required": [
                                  "family",
                                  "weight",
                                  "style"
                                ]
                              }
                            },
                            "masks": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "subject": {
                                    "type": "string",
                                    "enum": [
                                      "product",
                                      "person",
                                      "object"
                                    ]
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200
                                  },
                                  "src": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                },
                                "required": [
                                  "subject",
                                  "label",
                                  "src"
                                ]
                              }
                            },
                            "src": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/image"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "image/png",
                                        "image/jpeg",
                                        "image/gif",
                                        "image/webp",
                                        "image/svg+xml"
                                      ]
                                    },
                                    "srcSet": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url",
                                          "width"
                                        ]
                                      }
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/video"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "video/mp4",
                                        "video/webm",
                                        "video/quicktime"
                                      ]
                                    },
                                    "duration": {
                                      "type": "number",
                                      "exclusiveMinimum": 0
                                    },
                                    "thumbnail": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                }
                              ]
                            }
                          },
                          "required": [
                            "version",
                            "width",
                            "height",
                            "duration",
                            "layers"
                          ],
                          "x-ghostpull-asset": "composition"
                        }
                      },
                      "required": [
                        "id",
                        "version",
                        "visibility",
                        "asset"
                      ]
                    },
                    "variant": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255,
                      "description": "The variant's externalId; left out, the asset belongs to the whole product",
                      "examples": [
                        "HOOD-S"
                      ]
                    },
                    "position": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 2147483647,
                      "description": "The order among the links of the product, or of the variant; 1 comes first",
                      "examples": [
                        1
                      ]
                    },
                    "run": {
                      "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                      "type": "object",
                      "properties": {
                        "runId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        "addonId": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "runId",
                        "addonId"
                      ]
                    }
                  },
                  "required": [
                    "asset",
                    "position"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Variant not found",
                      "details": {
                        "resource": "Variant"
                      }
                    }
                  },
                  "not_found_2": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Asset not found",
                      "details": {
                        "resource": "Asset"
                      }
                    }
                  },
                  "not_found_3": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product asset not found",
                      "details": {
                        "resource": "Product asset"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `commerce.product_assets_full`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "commerce.product_assets_full": {
                    "summary": "commerce.product_assets_full",
                    "value": {
                      "code": "commerce.product_assets_full",
                      "error": "A product links at most 250 assets.",
                      "details": {
                        "max": 250
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "assetId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "A library asset of the account, from listMediaAssets"
                  },
                  "variant": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "The variant's externalId; left out, the asset belongs to the whole product",
                    "examples": [
                      "HOOD-S"
                    ]
                  }
                },
                "required": [
                  "assetId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/products/{productId}/assets/{assetId}": {
      "patch": {
        "operationId": "moveProductAsset",
        "tags": [
          "commerce"
        ],
        "summary": "Move a linked asset within its product or variant",
        "description": "Moves the link to `position` among the product's links, or with `variant` among that variant's, and numbers the others after it; a position past the end makes it the last.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "200": {
            "description": "Moved",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "asset": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The stable asset ID, shared by its versions."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The immutable version number of this asset, starting at 1."
                        },
                        "visibility": {
                          "type": "string",
                          "enum": [
                            "library",
                            "kept",
                            "job"
                          ],
                          "description": "library: listed in the account's library; kept: stored but unlisted; job: available only to its run."
                        },
                        "asset": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/image"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/png",
                                    "image/jpeg",
                                    "image/gif",
                                    "image/webp",
                                    "image/svg+xml"
                                  ]
                                },
                                "srcSet": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url",
                                      "width"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/video"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "width": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "height": {
                                  "examples": [
                                    1200
                                  ],
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "video/mp4",
                                    "video/webm",
                                    "video/quicktime"
                                  ]
                                },
                                "duration": {
                                  "type": "number",
                                  "exclusiveMinimum": 0
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/3d"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "model/gltf-binary",
                                    "model/gltf+json"
                                  ]
                                },
                                "thumbnail": {
                                  "type": "object",
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "url"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/json"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "application/json"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/vector"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "image/svg+xml"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "asset/font"
                                },
                                "url": {
                                  "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                  "examples": [
                                    "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "key": {
                                  "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                  "examples": [
                                    "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                  ],
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "name": {
                                  "description": "The display name, such as the original file name.",
                                  "examples": [
                                    "shoe.png"
                                  ],
                                  "type": "string",
                                  "minLength": 1
                                },
                                "mediaType": {
                                  "type": "string",
                                  "enum": [
                                    "font/ttf",
                                    "font/otf"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ]
                            }
                          ],
                          "description": "The file at this version. Download URLs expire; read the asset again to obtain a fresh one."
                        },
                        "editable": {
                          "description": "An asset whose layers can be changed: get the asset by its ID for its composition.",
                          "type": "boolean",
                          "const": true
                        },
                        "composition": {
                          "description": "For an editable asset, only when getting one asset by its ID: the layers this version was rendered from. Change them and start the Addon that takes a composition input and an input of this asset's type to make the next version.",
                          "type": "object",
                          "properties": {
                            "version": {
                              "type": "number",
                              "const": 1
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1
                            },
                            "width": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "height": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 8192
                            },
                            "duration": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 3600
                            },
                            "fps": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 60
                            },
                            "loop": {
                              "type": "boolean"
                            },
                            "background": {
                              "type": "string",
                              "minLength": 1
                            },
                            "layers": {
                              "type": "array",
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "image"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/image"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "image/png",
                                              "image/jpeg",
                                              "image/gif",
                                              "image/webp",
                                              "image/svg+xml"
                                            ]
                                          },
                                          "srcSet": {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "url": {
                                                  "type": "string",
                                                  "minLength": 1
                                                },
                                                "width": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991
                                                }
                                              },
                                              "required": [
                                                "url",
                                                "width"
                                              ]
                                            }
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "cutoutOf": {
                                        "type": "string",
                                        "enum": [
                                          "person",
                                          "product"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "video"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/video"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "height": {
                                            "examples": [
                                              1200
                                            ],
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "video/mp4",
                                              "video/webm",
                                              "video/quicktime"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          },
                                          "thumbnail": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "height": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url"
                                            ]
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "fit": {
                                        "type": "string",
                                        "enum": [
                                          "contain",
                                          "cover"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "trim": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "loop": {
                                        "type": "boolean"
                                      },
                                      "volume": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "audio"
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "type": {
                                            "type": "string",
                                            "const": "asset/audio"
                                          },
                                          "url": {
                                            "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                            "examples": [
                                              "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "key": {
                                            "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                            "examples": [
                                              "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                            ],
                                            "type": "string",
                                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                          },
                                          "name": {
                                            "description": "The display name, such as the original file name.",
                                            "examples": [
                                              "shoe.png"
                                            ],
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "mediaType": {
                                            "type": "string",
                                            "enum": [
                                              "audio/mpeg",
                                              "audio/wav",
                                              "audio/ogg",
                                              "audio/aac",
                                              "audio/mp4"
                                            ]
                                          },
                                          "duration": {
                                            "type": "number",
                                            "exclusiveMinimum": 0
                                          }
                                        },
                                        "required": [
                                          "type"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "volume"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "asset"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "text"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "fontFamily": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "fontWeight": {
                                        "type": "integer",
                                        "minimum": 100,
                                        "maximum": 900
                                      },
                                      "fontStyle": {
                                        "type": "string",
                                        "enum": [
                                          "normal",
                                          "italic"
                                        ]
                                      },
                                      "fontSize": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 1
                                      },
                                      "lineHeight": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "letterSpacing": {
                                        "type": "number",
                                        "minimum": -0.2,
                                        "maximum": 1
                                      },
                                      "textTransform": {
                                        "type": "string",
                                        "enum": [
                                          "none",
                                          "uppercase"
                                        ]
                                      },
                                      "lineBreaks": {
                                        "type": "string",
                                        "const": "explicit"
                                      },
                                      "color": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "align": {
                                        "type": "string",
                                        "enum": [
                                          "left",
                                          "center",
                                          "right"
                                        ]
                                      },
                                      "spans": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "fontFamily": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "fontWeight": {
                                              "type": "integer",
                                              "minimum": 100,
                                              "maximum": 900
                                            },
                                            "fontStyle": {
                                              "type": "string",
                                              "enum": [
                                                "normal",
                                                "italic"
                                              ]
                                            },
                                            "color": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "start": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "end": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "start",
                                            "end"
                                          ]
                                        }
                                      },
                                      "path": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "arc"
                                              },
                                              "center": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "radius": {
                                                "type": "number",
                                                "exclusiveMinimum": 0
                                              },
                                              "startAngle": {
                                                "type": "number"
                                              },
                                              "sweepAngle": {
                                                "type": "number",
                                                "minimum": -360,
                                                "maximum": 360
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "radius",
                                              "sweepAngle"
                                            ]
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "bezier"
                                              },
                                              "start": {
                                                "type": "object",
                                                "properties": {
                                                  "x": {
                                                    "type": "number"
                                                  },
                                                  "y": {
                                                    "type": "number"
                                                  }
                                                },
                                                "required": [
                                                  "x",
                                                  "y"
                                                ]
                                              },
                                              "segments": {
                                                "minItems": 1,
                                                "maxItems": 64,
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "control1": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "control2": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    },
                                                    "end": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "control1",
                                                    "control2",
                                                    "end"
                                                  ]
                                                }
                                              },
                                              "fit": {
                                                "type": "string",
                                                "enum": [
                                                  "shrink",
                                                  "clip"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "start",
                                              "segments"
                                            ]
                                          }
                                        ]
                                      },
                                      "units": {
                                        "type": "object",
                                        "properties": {
                                          "by": {
                                            "type": "string",
                                            "enum": [
                                              "character",
                                              "word",
                                              "line"
                                            ]
                                          },
                                          "stagger": {
                                            "type": "number",
                                            "minimum": 0
                                          },
                                          "reverse": {
                                            "type": "boolean"
                                          },
                                          "animate": {
                                            "type": "object",
                                            "propertyNames": {
                                              "type": "string",
                                              "enum": [
                                                "x",
                                                "y",
                                                "rotation",
                                                "opacity",
                                                "scale"
                                              ]
                                            },
                                            "additionalProperties": {
                                              "minItems": 1,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "time": {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  "value": {
                                                    "type": "number"
                                                  },
                                                  "easing": {
                                                    "type": "string",
                                                    "enum": [
                                                      "linear",
                                                      "ease-in",
                                                      "ease-out",
                                                      "ease-in-out",
                                                      "step"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "time",
                                                  "value"
                                                ]
                                              }
                                            }
                                          }
                                        },
                                        "required": [
                                          "by",
                                          "stagger",
                                          "animate"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale",
                                            "fontSize"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "text"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "shape"
                                      },
                                      "shape": {
                                        "type": "string",
                                        "enum": [
                                          "rectangle",
                                          "ellipse",
                                          "path"
                                        ]
                                      },
                                      "points": {
                                        "minItems": 3,
                                        "maxItems": 64,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "prefixItems": [
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            {
                                              "type": "number",
                                              "minimum": 0,
                                              "maximum": 1
                                            }
                                          ],
                                          "items": false,
                                          "minItems": 2,
                                          "maxItems": 2
                                        }
                                      },
                                      "fill": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "stroke": {
                                        "type": "object",
                                        "properties": {
                                          "color": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "number",
                                            "exclusiveMinimum": 0,
                                            "maximum": 0.05
                                          }
                                        },
                                        "required": [
                                          "color",
                                          "width"
                                        ]
                                      },
                                      "radius": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind"
                                    ]
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "role": {
                                        "type": "string",
                                        "enum": [
                                          "background",
                                          "subject",
                                          "logo",
                                          "headline",
                                          "subline",
                                          "cta",
                                          "label",
                                          "container",
                                          "pointer",
                                          "area"
                                        ]
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "hidden": {
                                        "type": "boolean"
                                      },
                                      "start": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "duration": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "x": {
                                        "type": "number"
                                      },
                                      "y": {
                                        "type": "number"
                                      },
                                      "width": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "height": {
                                        "type": "number",
                                        "exclusiveMinimum": 0
                                      },
                                      "rotation": {
                                        "type": "number"
                                      },
                                      "opacity": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      },
                                      "scale": {
                                        "type": "number",
                                        "minimum": 0
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "three"
                                      },
                                      "scene": {
                                        "type": "object",
                                        "properties": {
                                          "camera": {
                                            "oneOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "perspective"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "fov": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0,
                                                    "exclusiveMaximum": 180
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "orthographic"
                                                  },
                                                  "position": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "object",
                                                    "properties": {
                                                      "x": {
                                                        "type": "number"
                                                      },
                                                      "y": {
                                                        "type": "number"
                                                      },
                                                      "z": {
                                                        "type": "number"
                                                      }
                                                    },
                                                    "required": [
                                                      "x",
                                                      "y",
                                                      "z"
                                                    ]
                                                  },
                                                  "near": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "far": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  },
                                                  "height": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "kind"
                                                ]
                                              }
                                            ]
                                          },
                                          "nodes": {
                                            "type": "array",
                                            "items": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "group"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "mesh"
                                                    },
                                                    "geometry": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "box"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "depth": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height",
                                                            "depth"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sphere"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "plane"
                                                            },
                                                            "width": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "width",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "cylinder"
                                                            },
                                                            "radiusTop": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "radiusBottom": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "height": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radiusTop",
                                                            "radiusBottom",
                                                            "height"
                                                          ]
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "torus"
                                                            },
                                                            "radius": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            },
                                                            "tube": {
                                                              "type": "number",
                                                              "exclusiveMinimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "radius",
                                                            "tube"
                                                          ]
                                                        }
                                                      ]
                                                    },
                                                    "material": {
                                                      "type": "object",
                                                      "properties": {
                                                        "color": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "opacity": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "metalness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "roughness": {
                                                          "type": "number",
                                                          "minimum": 0,
                                                          "maximum": 1
                                                        },
                                                        "doubleSided": {
                                                          "type": "boolean"
                                                        }
                                                      }
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "geometry"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "model"
                                                    },
                                                    "asset": {
                                                      "type": "object",
                                                      "properties": {
                                                        "type": {
                                                          "type": "string",
                                                          "const": "asset/3d"
                                                        },
                                                        "url": {
                                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                                          "examples": [
                                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "key": {
                                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                                          "examples": [
                                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                                          ],
                                                          "type": "string",
                                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                                        },
                                                        "name": {
                                                          "description": "The display name, such as the original file name.",
                                                          "examples": [
                                                            "shoe.png"
                                                          ],
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "mediaType": {
                                                          "type": "string",
                                                          "enum": [
                                                            "model/gltf-binary",
                                                            "model/gltf+json"
                                                          ]
                                                        },
                                                        "thumbnail": {
                                                          "type": "object",
                                                          "properties": {
                                                            "url": {
                                                              "type": "string",
                                                              "minLength": 1
                                                            },
                                                            "width": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            },
                                                            "height": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991
                                                            }
                                                          },
                                                          "required": [
                                                            "url"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "type"
                                                      ]
                                                    },
                                                    "clip": {
                                                      "type": "object",
                                                      "properties": {
                                                        "name": {
                                                          "type": "string",
                                                          "minLength": 1
                                                        },
                                                        "offset": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "speed": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "loop": {
                                                          "type": "boolean"
                                                        }
                                                      },
                                                      "required": [
                                                        "name"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind",
                                                    "asset"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "ambient-light"
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "directional-light"
                                                    },
                                                    "target": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "id": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "parentId": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "visible": {
                                                      "type": "boolean"
                                                    },
                                                    "position": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "rotation": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number"
                                                        },
                                                        "y": {
                                                          "type": "number"
                                                        },
                                                        "z": {
                                                          "type": "number"
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "scale": {
                                                      "type": "object",
                                                      "properties": {
                                                        "x": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "y": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        },
                                                        "z": {
                                                          "type": "number",
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "x",
                                                        "y",
                                                        "z"
                                                      ]
                                                    },
                                                    "animate": {
                                                      "type": "object",
                                                      "propertyNames": {
                                                        "type": "string",
                                                        "enum": [
                                                          "position.x",
                                                          "position.y",
                                                          "position.z",
                                                          "rotation.x",
                                                          "rotation.y",
                                                          "rotation.z",
                                                          "scale.x",
                                                          "scale.y",
                                                          "scale.z"
                                                        ]
                                                      },
                                                      "additionalProperties": {
                                                        "minItems": 1,
                                                        "type": "array",
                                                        "items": {
                                                          "type": "object",
                                                          "properties": {
                                                            "time": {
                                                              "type": "number",
                                                              "minimum": 0
                                                            },
                                                            "value": {
                                                              "type": "number"
                                                            },
                                                            "easing": {
                                                              "type": "string",
                                                              "enum": [
                                                                "linear",
                                                                "ease-in",
                                                                "ease-out",
                                                                "ease-in-out",
                                                                "step"
                                                              ]
                                                            }
                                                          },
                                                          "required": [
                                                            "time",
                                                            "value"
                                                          ]
                                                        }
                                                      }
                                                    },
                                                    "color": {
                                                      "type": "string",
                                                      "minLength": 1
                                                    },
                                                    "intensity": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "point-light"
                                                    },
                                                    "distance": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    },
                                                    "decay": {
                                                      "type": "number",
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "id",
                                                    "kind"
                                                  ]
                                                }
                                              ]
                                            }
                                          },
                                          "background": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "exposure": {
                                            "type": "number",
                                            "minimum": 0
                                          }
                                        },
                                        "required": [
                                          "nodes"
                                        ]
                                      },
                                      "animate": {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string",
                                          "enum": [
                                            "x",
                                            "y",
                                            "width",
                                            "height",
                                            "rotation",
                                            "opacity",
                                            "scale"
                                          ]
                                        },
                                        "additionalProperties": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "time": {
                                                "type": "number",
                                                "minimum": 0
                                              },
                                              "value": {
                                                "type": "number"
                                              },
                                              "easing": {
                                                "type": "string",
                                                "enum": [
                                                  "linear",
                                                  "ease-in",
                                                  "ease-out",
                                                  "ease-in-out",
                                                  "step"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "time",
                                              "value"
                                            ]
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "scene"
                                    ]
                                  }
                                ]
                              }
                            },
                            "fonts": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "family": {
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "weight": {
                                    "type": "integer",
                                    "minimum": 100,
                                    "maximum": 900
                                  },
                                  "style": {
                                    "type": "string",
                                    "enum": [
                                      "normal",
                                      "italic"
                                    ]
                                  },
                                  "file": {
                                    "type": "string",
                                    "pattern": "^[a-z0-9-]+\\.(ttf|otf|woff2)$"
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/font"
                                      },
                                      "key": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "font/ttf",
                                          "font/otf"
                                        ]
                                      },
                                      "url": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "key",
                                      "mediaType"
                                    ]
                                  }
                                },
                                "required": [
                                  "family",
                                  "weight",
                                  "style"
                                ]
                              }
                            },
                            "masks": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "subject": {
                                    "type": "string",
                                    "enum": [
                                      "product",
                                      "person",
                                      "object"
                                    ]
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200
                                  },
                                  "src": {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "asset/image"
                                      },
                                      "url": {
                                        "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                        "examples": [
                                          "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "key": {
                                        "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                        "examples": [
                                          "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                        ],
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "name": {
                                        "description": "The display name, such as the original file name.",
                                        "examples": [
                                          "shoe.png"
                                        ],
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "examples": [
                                          1200
                                        ],
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "enum": [
                                          "image/png",
                                          "image/jpeg",
                                          "image/gif",
                                          "image/webp",
                                          "image/svg+xml"
                                        ]
                                      },
                                      "srcSet": {
                                        "minItems": 1,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url",
                                            "width"
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  }
                                },
                                "required": [
                                  "subject",
                                  "label",
                                  "src"
                                ]
                              }
                            },
                            "src": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/image"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "image/png",
                                        "image/jpeg",
                                        "image/gif",
                                        "image/webp",
                                        "image/svg+xml"
                                      ]
                                    },
                                    "srcSet": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "url": {
                                            "type": "string",
                                            "minLength": 1
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "url",
                                          "width"
                                        ]
                                      }
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "asset/video"
                                    },
                                    "url": {
                                      "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                      "examples": [
                                        "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "key": {
                                      "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                      "examples": [
                                        "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                      ],
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                    },
                                    "name": {
                                      "description": "The display name, such as the original file name.",
                                      "examples": [
                                        "shoe.png"
                                      ],
                                      "type": "string",
                                      "minLength": 1
                                    },
                                    "width": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "height": {
                                      "examples": [
                                        1200
                                      ],
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "mediaType": {
                                      "type": "string",
                                      "enum": [
                                        "video/mp4",
                                        "video/webm",
                                        "video/quicktime"
                                      ]
                                    },
                                    "duration": {
                                      "type": "number",
                                      "exclusiveMinimum": 0
                                    },
                                    "thumbnail": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ]
                                }
                              ]
                            }
                          },
                          "required": [
                            "version",
                            "width",
                            "height",
                            "duration",
                            "layers"
                          ],
                          "x-ghostpull-asset": "composition"
                        }
                      },
                      "required": [
                        "id",
                        "version",
                        "visibility",
                        "asset"
                      ]
                    },
                    "variant": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255,
                      "description": "The variant's externalId; left out, the asset belongs to the whole product",
                      "examples": [
                        "HOOD-S"
                      ]
                    },
                    "position": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 2147483647,
                      "description": "The order among the links of the product, or of the variant; 1 comes first",
                      "examples": [
                        1
                      ]
                    },
                    "run": {
                      "description": "The run that made the asset, linked when it succeeded; read it with getOrchestratorRun. Left out for an asset someone linked.",
                      "type": "object",
                      "properties": {
                        "runId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        "addonId": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "runId",
                        "addonId"
                      ]
                    }
                  },
                  "required": [
                    "asset",
                    "position"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Variant not found",
                      "details": {
                        "resource": "Variant"
                      }
                    }
                  },
                  "not_found_2": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Asset not found",
                      "details": {
                        "resource": "Asset"
                      }
                    }
                  },
                  "not_found_3": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product asset not found",
                      "details": {
                        "resource": "Product asset"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "assetId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "position": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 2147483647,
                    "description": "The new place among the links of the product or variant"
                  },
                  "variant": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "The variant's externalId; left out, the asset belongs to the whole product",
                    "examples": [
                      "HOOD-S"
                    ]
                  }
                },
                "required": [
                  "position"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "products:write"
      },
      "delete": {
        "operationId": "unlinkProductAsset",
        "tags": [
          "commerce"
        ],
        "summary": "Unlink an asset from a product or one of its variants",
        "description": "Removes the link between the product, or with `variant` one of its variants, and the asset. The asset itself stays in the media library.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:write`.",
        "responses": {
          "204": {
            "description": "Unlinked"
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:write.",
                      "details": {
                        "permission": "products:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product not found",
                      "details": {
                        "resource": "Product"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Variant not found",
                      "details": {
                        "resource": "Variant"
                      }
                    }
                  },
                  "not_found_2": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Asset not found",
                      "details": {
                        "resource": "Asset"
                      }
                    }
                  },
                  "not_found_3": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Product asset not found",
                      "details": {
                        "resource": "Product asset"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "productId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "assetId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "query",
            "name": "variant",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 255,
              "examples": [
                "HOOD-S"
              ]
            },
            "description": "The variant's externalId; left out, the asset belongs to the whole product"
          }
        ],
        "x-ghostpull-permission": "products:write"
      }
    },
    "/api/v1/commerce/assets/{assetId}/products": {
      "get": {
        "operationId": "listAssetProducts",
        "tags": [
          "commerce"
        ],
        "summary": "List the products an asset is linked to",
        "description": "Returns the products, newest first and at most 100, that the media library asset is linked to, directly or through one of their variants.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `products:read`.",
        "responses": {
          "200": {
            "description": "The products",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "examples": [
                              "019a4c2f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
                            ]
                          },
                          "catalogId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "examples": [
                              "019a4c2e-8b1f-7d3a-9c5e-2f6b8a1d4e7c"
                            ]
                          },
                          "title": {
                            "type": "string",
                            "examples": [
                              "Classic Hoodie"
                            ]
                          },
                          "brand": {
                            "examples": [
                              "Nordfaden Studio"
                            ],
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "active",
                              "draft",
                              "archived"
                            ]
                          },
                          "imagesLoading": {
                            "type": "boolean",
                            "description": "Whether shop images of the product are still being loaded into Media",
                            "examples": [
                              false
                            ]
                          },
                          "mainImageUrl": {
                            "description": "A short-lived link to the product's first loaded image, else its first linked asset",
                            "examples": [
                              "https://media.ghostpull.example/accounts/…/front.webp"
                            ],
                            "type": "string"
                          },
                          "variantCount": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991,
                            "examples": [
                              3
                            ]
                          },
                          "priceFrom": {
                            "type": "string",
                            "pattern": "^\\d{1,20}(\\.\\d{1,8})?$",
                            "examples": [
                              "19.90"
                            ]
                          },
                          "currency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$",
                            "examples": [
                              "EUR"
                            ]
                          },
                          "generatedImages": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many images and videos Addon runs made for the product that are still in the media library; 0 when none yet",
                            "examples": [
                              2
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "catalogId",
                          "title",
                          "status",
                          "imagesLoading",
                          "variantCount",
                          "currency",
                          "generatedImages"
                        ]
                      }
                    }
                  },
                  "required": [
                    "products"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission products:read.",
                      "details": {
                        "permission": "products:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "assetId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "products:read"
      }
    },
    "/api/v1/brands/analyses": {
      "post": {
        "operationId": "startBrandAnalysis",
        "tags": [
          "brands"
        ],
        "summary": "Analyze a shop's brand from its web address",
        "description": "Reads a shop's homepage and drafts its brand: name, tagline, industry, colors, fonts, tone, a `look` for image prompts and a `voice` for copy. Answers 202 with the analysis, `reading` at first; its draft fills in as findings arrive, within about 20 seconds, and it ends `done` or `failed`. The address may be written in any form (`shop.com`, `https://www.shop.com/products/x`); a shop is told apart by its host, so analyzing it again drafts the same shop's brand again. Nothing becomes a brand until it is approved.\n\n- **Then:** `getBrandAnalysis` until its status is `done` or `failed`, then `approveBrandAnalysis`.\n- **Polling:** every second or two; an analysis never runs longer than a minute.\n- **Limits:** Each user or API key may call it 10 times an hour and 30 times a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "202": {
            "description": "The analysis, just started",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "url": {
                      "type": "string"
                    },
                    "shopId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "reading",
                        "analyzing",
                        "done",
                        "failed"
                      ]
                    },
                    "failure": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "not_public",
                            "blocked",
                            "not_found",
                            "not_html",
                            "unreachable"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "enum": [
                              "read",
                              "logo",
                              "colors",
                              "fonts",
                              "tone",
                              "done"
                            ]
                          },
                          "text": {
                            "type": "string"
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          }
                        },
                        "required": [
                          "key",
                          "text",
                          "at"
                        ]
                      }
                    },
                    "draft": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "additionalProperties": {}
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "brandId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "endedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "url",
                    "shopId",
                    "status",
                    "failure",
                    "events",
                    "draft",
                    "logoUrl",
                    "iconUrl",
                    "brandId",
                    "createdAt",
                    "endedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `brands.invalid_url`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.invalid_url": {
                    "summary": "brands.invalid_url",
                    "value": {
                      "code": "brands.invalid_url",
                      "error": "The address is not a web address of a shop."
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/brands/analyses/{analysisId}": {
      "get": {
        "operationId": "getBrandAnalysis",
        "tags": [
          "brands"
        ],
        "summary": "Read a brand analysis",
        "description": "Returns an analysis: its `status` (`reading`, `analyzing`, `done` or `failed`), `failure` when it failed (`not_public`, `blocked`, `not_found`, `not_html` or `unreachable`: the homepage could not be read), `events` (what was found, in order) and `draft`, the brand as far as it is read (each part, such as `colors`, comes whole or not at all). `logoUrl` and `iconUrl` are short-lived links to show the draft's logo and icon once they are in (null before). `brandId` is set once it was approved.\n\n- **Before:** `startBrandAnalysis`.\n- **Then:** show the draft to the user, and `approveBrandAnalysis` once its status is `done` and the user agrees.\n- **Polling:** every second or two while `status` is `reading` or `analyzing`.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:read`.",
        "responses": {
          "200": {
            "description": "The analysis",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "url": {
                      "type": "string"
                    },
                    "shopId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "reading",
                        "analyzing",
                        "done",
                        "failed"
                      ]
                    },
                    "failure": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "not_public",
                            "blocked",
                            "not_found",
                            "not_html",
                            "unreachable"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "enum": [
                              "read",
                              "logo",
                              "colors",
                              "fonts",
                              "tone",
                              "done"
                            ]
                          },
                          "text": {
                            "type": "string"
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          }
                        },
                        "required": [
                          "key",
                          "text",
                          "at"
                        ]
                      }
                    },
                    "draft": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "additionalProperties": {}
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "brandId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "endedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "url",
                    "shopId",
                    "status",
                    "failure",
                    "events",
                    "draft",
                    "logoUrl",
                    "iconUrl",
                    "brandId",
                    "createdAt",
                    "endedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:read.",
                      "details": {
                        "permission": "brands:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand analysis not found",
                      "details": {
                        "resource": "Brand analysis"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "analysisId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:read"
      }
    },
    "/api/v1/brands/analyses/{analysisId}/approve": {
      "post": {
        "operationId": "approveBrandAnalysis",
        "tags": [
          "brands"
        ],
        "summary": "Approve a brand analysis as the shop's brand",
        "description": "Saves the brand of a `done` analysis and answers it. Without `profile` the analysis' draft becomes the brand; with `profile`, the whole brand profile as the user edited it, that does. A shop has one brand: if it has one, its fields are replaced and its `id` and default flag stay; otherwise a brand is created, which is the account's default if the account has none. `logo` and `icon` must be the account's own images or SVGs: the analysis' logo or icon, or one from the media library.\n\n- **Before:** `getBrandAnalysis` until the status is `done`; show the user the draft and approve only once they agree.\n- **Then:** `listBrands` shows the account's brands, the default first.\n- **Retries:** approving an analysis again stores the same profile again.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The brand",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `brands.invalid_image`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.invalid_image": {
                    "summary": "brands.invalid_image",
                    "value": {
                      "code": "brands.invalid_image",
                      "error": "The logo must be a ready image or SVG of this account.",
                      "details": {
                        "field": "logo"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand analysis not found",
                      "details": {
                        "resource": "Brand analysis"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `brands.analysis_not_done`, `brands.changed_meanwhile`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.analysis_not_done": {
                    "summary": "brands.analysis_not_done",
                    "value": {
                      "code": "brands.analysis_not_done",
                      "error": "The analysis is reading; only a done analysis can be approved.",
                      "details": {
                        "status": "reading"
                      }
                    }
                  },
                  "brands.changed_meanwhile": {
                    "summary": "brands.changed_meanwhile",
                    "value": {
                      "code": "brands.changed_meanwhile",
                      "error": "The account's brands changed at the same moment; try again."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "analysisId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 60
                      },
                      "tagline": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "industry": {
                        "type": "string",
                        "enum": [
                          "home-and-living",
                          "appliances-and-electronics",
                          "skincare-and-beauty",
                          "fashion-and-apparel",
                          "sports-and-outdoor",
                          "jewelry-and-accessories",
                          "food-and-drink",
                          "kids-and-baby",
                          "pets",
                          "art-and-stationery",
                          "other"
                        ]
                      },
                      "language": {
                        "type": "string",
                        "maxLength": 35
                      },
                      "colors": {
                        "type": "object",
                        "properties": {
                          "primary": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "secondary": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "accent": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "background": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "text": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "extra": {
                            "maxItems": 4,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            }
                          }
                        },
                        "required": [
                          "primary",
                          "secondary",
                          "accent",
                          "background",
                          "text",
                          "extra"
                        ],
                        "additionalProperties": false
                      },
                      "fonts": {
                        "type": "object",
                        "properties": {
                          "heading": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fallback": {
                                "type": "string",
                                "enum": [
                                  "serif",
                                  "sans-serif"
                                ]
                              },
                              "source": {
                                "type": "string",
                                "enum": [
                                  "google",
                                  "shop"
                                ]
                              },
                              "googleFamily": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              }
                            },
                            "required": [
                              "family",
                              "fallback",
                              "source"
                            ],
                            "additionalProperties": false
                          },
                          "body": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fallback": {
                                "type": "string",
                                "enum": [
                                  "serif",
                                  "sans-serif"
                                ]
                              },
                              "source": {
                                "type": "string",
                                "enum": [
                                  "google",
                                  "shop"
                                ]
                              },
                              "googleFamily": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              }
                            },
                            "required": [
                              "family",
                              "fallback",
                              "source"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "heading",
                          "body"
                        ],
                        "additionalProperties": false
                      },
                      "tone": {
                        "type": "object",
                        "properties": {
                          "summary": {
                            "type": "string",
                            "maxLength": 400
                          },
                          "keywords": {
                            "maxItems": 5,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 30
                            }
                          },
                          "audience": {
                            "type": "string",
                            "maxLength": 160
                          }
                        },
                        "required": [
                          "summary",
                          "keywords",
                          "audience"
                        ],
                        "additionalProperties": false
                      },
                      "look": {
                        "type": "string",
                        "maxLength": 600
                      },
                      "voice": {
                        "type": "string",
                        "maxLength": 600
                      },
                      "social": {
                        "maxItems": 9,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "instagram",
                                "facebook",
                                "tiktok",
                                "pinterest",
                                "youtube",
                                "x",
                                "linkedin",
                                "threads",
                                "bluesky"
                              ]
                            },
                            "handle": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "url": {
                              "type": "string",
                              "maxLength": 2048,
                              "format": "uri"
                            }
                          },
                          "required": [
                            "platform",
                            "handle",
                            "url"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "logo": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                          },
                          "mediaType": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "key",
                          "mediaType"
                        ],
                        "additionalProperties": false
                      },
                      "icon": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                          },
                          "mediaType": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "key",
                          "mediaType"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "name",
                      "tagline",
                      "industry",
                      "language",
                      "colors",
                      "fonts",
                      "tone",
                      "look",
                      "voice",
                      "social"
                    ],
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/brands": {
      "get": {
        "operationId": "listBrands",
        "tags": [
          "brands"
        ],
        "summary": "List the account's brands",
        "description": "Returns the account's brands, the default first, then the oldest. A brand has an `id`, the `shopId` it was read from, `isDefault` and its `profile`: name, tagline, industry, colors, fonts, tone, `look` (for image prompts), `voice` (for copy), social links, and the logo and icon as media assets. To show them, `logoUrl` and `iconUrl` are links that stay valid for a short while (null when the brand has none or its file is gone), and `shopUrl` is the shop's address.\n\n- **Then:** `getBrand` for one brand.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:read`.",
        "responses": {
          "200": {
            "description": "The brands",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "brands": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "shopId": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "isDefault": {
                            "type": "boolean"
                          },
                          "profile": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 60
                              },
                              "tagline": {
                                "type": "string",
                                "maxLength": 120
                              },
                              "industry": {
                                "type": "string",
                                "enum": [
                                  "home-and-living",
                                  "appliances-and-electronics",
                                  "skincare-and-beauty",
                                  "fashion-and-apparel",
                                  "sports-and-outdoor",
                                  "jewelry-and-accessories",
                                  "food-and-drink",
                                  "kids-and-baby",
                                  "pets",
                                  "art-and-stationery",
                                  "other"
                                ]
                              },
                              "language": {
                                "type": "string",
                                "maxLength": 35
                              },
                              "colors": {
                                "type": "object",
                                "properties": {
                                  "primary": {
                                    "type": "string",
                                    "pattern": "^#[0-9a-f]{6}$"
                                  },
                                  "secondary": {
                                    "type": "string",
                                    "pattern": "^#[0-9a-f]{6}$"
                                  },
                                  "accent": {
                                    "type": "string",
                                    "pattern": "^#[0-9a-f]{6}$"
                                  },
                                  "background": {
                                    "type": "string",
                                    "pattern": "^#[0-9a-f]{6}$"
                                  },
                                  "text": {
                                    "type": "string",
                                    "pattern": "^#[0-9a-f]{6}$"
                                  },
                                  "extra": {
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "pattern": "^#[0-9a-f]{6}$"
                                    }
                                  }
                                },
                                "required": [
                                  "primary",
                                  "secondary",
                                  "accent",
                                  "background",
                                  "text",
                                  "extra"
                                ]
                              },
                              "fonts": {
                                "type": "object",
                                "properties": {
                                  "heading": {
                                    "type": "object",
                                    "properties": {
                                      "family": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 80
                                      },
                                      "fallback": {
                                        "type": "string",
                                        "enum": [
                                          "serif",
                                          "sans-serif"
                                        ]
                                      },
                                      "source": {
                                        "type": "string",
                                        "enum": [
                                          "google",
                                          "shop"
                                        ]
                                      },
                                      "googleFamily": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 80
                                      }
                                    },
                                    "required": [
                                      "family",
                                      "fallback",
                                      "source"
                                    ]
                                  },
                                  "body": {
                                    "type": "object",
                                    "properties": {
                                      "family": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 80
                                      },
                                      "fallback": {
                                        "type": "string",
                                        "enum": [
                                          "serif",
                                          "sans-serif"
                                        ]
                                      },
                                      "source": {
                                        "type": "string",
                                        "enum": [
                                          "google",
                                          "shop"
                                        ]
                                      },
                                      "googleFamily": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 80
                                      }
                                    },
                                    "required": [
                                      "family",
                                      "fallback",
                                      "source"
                                    ]
                                  }
                                },
                                "required": [
                                  "heading",
                                  "body"
                                ]
                              },
                              "tone": {
                                "type": "object",
                                "properties": {
                                  "summary": {
                                    "type": "string",
                                    "maxLength": 400
                                  },
                                  "keywords": {
                                    "maxItems": 5,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 30
                                    }
                                  },
                                  "audience": {
                                    "type": "string",
                                    "maxLength": 160
                                  }
                                },
                                "required": [
                                  "summary",
                                  "keywords",
                                  "audience"
                                ]
                              },
                              "look": {
                                "type": "string",
                                "maxLength": 600
                              },
                              "voice": {
                                "type": "string",
                                "maxLength": 600
                              },
                              "social": {
                                "maxItems": 9,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "platform": {
                                      "type": "string",
                                      "enum": [
                                        "instagram",
                                        "facebook",
                                        "tiktok",
                                        "pinterest",
                                        "youtube",
                                        "x",
                                        "linkedin",
                                        "threads",
                                        "bluesky"
                                      ]
                                    },
                                    "handle": {
                                      "type": "string",
                                      "maxLength": 100
                                    },
                                    "url": {
                                      "type": "string",
                                      "maxLength": 2048,
                                      "format": "uri"
                                    }
                                  },
                                  "required": [
                                    "platform",
                                    "handle",
                                    "url"
                                  ]
                                }
                              },
                              "logo": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "required": [
                                  "key",
                                  "mediaType"
                                ]
                              },
                              "icon": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "minLength": 1
                                  }
                                },
                                "required": [
                                  "key",
                                  "mediaType"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "tagline",
                              "industry",
                              "language",
                              "colors",
                              "fonts",
                              "tone",
                              "look",
                              "voice",
                              "social"
                            ],
                            "additionalProperties": {}
                          },
                          "fontFiles": {
                            "default": {},
                            "type": "object",
                            "properties": {
                              "heading": {
                                "type": "object",
                                "properties": {
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "minLength": 1
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "mediaType"
                                    ]
                                  },
                                  "source": {
                                    "type": "string",
                                    "enum": [
                                      "upload",
                                      "google"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255
                                  }
                                },
                                "required": [
                                  "asset",
                                  "source",
                                  "name"
                                ]
                              },
                              "body": {
                                "type": "object",
                                "properties": {
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                      },
                                      "mediaType": {
                                        "type": "string",
                                        "minLength": 1
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "mediaType"
                                    ]
                                  },
                                  "source": {
                                    "type": "string",
                                    "enum": [
                                      "upload",
                                      "google"
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255
                                  }
                                },
                                "required": [
                                  "asset",
                                  "source",
                                  "name"
                                ]
                              }
                            }
                          },
                          "logoUrl": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "iconUrl": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "shopUrl": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "uri"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          }
                        },
                        "required": [
                          "id",
                          "shopId",
                          "isDefault",
                          "profile",
                          "logoUrl",
                          "iconUrl",
                          "shopUrl",
                          "createdAt",
                          "updatedAt"
                        ]
                      }
                    }
                  },
                  "required": [
                    "brands"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:read.",
                      "details": {
                        "permission": "brands:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-ghostpull-permission": "brands:read"
      }
    },
    "/api/v1/brands/{brandId}": {
      "get": {
        "operationId": "getBrand",
        "tags": [
          "brands"
        ],
        "summary": "Read a brand",
        "description": "Returns one brand with its whole profile.\n\n- **Before:** `listBrands` for the brand's `id`.\n- **Then:** `updateBrand` sends the whole profile back, changed.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:read`.",
        "responses": {
          "200": {
            "description": "The brand",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:read.",
                      "details": {
                        "permission": "brands:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:read"
      },
      "patch": {
        "operationId": "updateBrand",
        "tags": [
          "brands"
        ],
        "summary": "Edit a brand",
        "description": "Replaces the brand's profile with the one sent and answers the brand; its `id`, shop and default flag stay. Send the whole profile, read with `getBrand` and changed: a `logo` or `icon` left out is removed. `logo` and `icon` must be the account's own images or SVGs: the analysis' logo or icon, or one from the media library.\n\n- **Before:** `getBrand`.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The changed brand",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `brands.invalid_image`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.invalid_image": {
                    "summary": "brands.invalid_image",
                    "value": {
                      "code": "brands.invalid_image",
                      "error": "The logo must be a ready image or SVG of this account.",
                      "details": {
                        "field": "logo"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 60
                      },
                      "tagline": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "industry": {
                        "type": "string",
                        "enum": [
                          "home-and-living",
                          "appliances-and-electronics",
                          "skincare-and-beauty",
                          "fashion-and-apparel",
                          "sports-and-outdoor",
                          "jewelry-and-accessories",
                          "food-and-drink",
                          "kids-and-baby",
                          "pets",
                          "art-and-stationery",
                          "other"
                        ]
                      },
                      "language": {
                        "type": "string",
                        "maxLength": 35
                      },
                      "colors": {
                        "type": "object",
                        "properties": {
                          "primary": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "secondary": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "accent": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "background": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "text": {
                            "type": "string",
                            "pattern": "^#[0-9a-f]{6}$"
                          },
                          "extra": {
                            "maxItems": 4,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            }
                          }
                        },
                        "required": [
                          "primary",
                          "secondary",
                          "accent",
                          "background",
                          "text",
                          "extra"
                        ],
                        "additionalProperties": false
                      },
                      "fonts": {
                        "type": "object",
                        "properties": {
                          "heading": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fallback": {
                                "type": "string",
                                "enum": [
                                  "serif",
                                  "sans-serif"
                                ]
                              },
                              "source": {
                                "type": "string",
                                "enum": [
                                  "google",
                                  "shop"
                                ]
                              },
                              "googleFamily": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              }
                            },
                            "required": [
                              "family",
                              "fallback",
                              "source"
                            ],
                            "additionalProperties": false
                          },
                          "body": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fallback": {
                                "type": "string",
                                "enum": [
                                  "serif",
                                  "sans-serif"
                                ]
                              },
                              "source": {
                                "type": "string",
                                "enum": [
                                  "google",
                                  "shop"
                                ]
                              },
                              "googleFamily": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              }
                            },
                            "required": [
                              "family",
                              "fallback",
                              "source"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "heading",
                          "body"
                        ],
                        "additionalProperties": false
                      },
                      "tone": {
                        "type": "object",
                        "properties": {
                          "summary": {
                            "type": "string",
                            "maxLength": 400
                          },
                          "keywords": {
                            "maxItems": 5,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 30
                            }
                          },
                          "audience": {
                            "type": "string",
                            "maxLength": 160
                          }
                        },
                        "required": [
                          "summary",
                          "keywords",
                          "audience"
                        ],
                        "additionalProperties": false
                      },
                      "look": {
                        "type": "string",
                        "maxLength": 600
                      },
                      "voice": {
                        "type": "string",
                        "maxLength": 600
                      },
                      "social": {
                        "maxItems": 9,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "instagram",
                                "facebook",
                                "tiktok",
                                "pinterest",
                                "youtube",
                                "x",
                                "linkedin",
                                "threads",
                                "bluesky"
                              ]
                            },
                            "handle": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "url": {
                              "type": "string",
                              "maxLength": 2048,
                              "format": "uri"
                            }
                          },
                          "required": [
                            "platform",
                            "handle",
                            "url"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "logo": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                          },
                          "mediaType": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "key",
                          "mediaType"
                        ],
                        "additionalProperties": false
                      },
                      "icon": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                          },
                          "mediaType": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "key",
                          "mediaType"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "name",
                      "tagline",
                      "industry",
                      "language",
                      "colors",
                      "fonts",
                      "tone",
                      "look",
                      "voice",
                      "social"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "profile"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "brands:write"
      },
      "delete": {
        "operationId": "deleteBrand",
        "tags": [
          "brands"
        ],
        "summary": "Delete a brand",
        "description": "Deletes the brand and nothing else: its analyses stay, and a logo picked from the media library stays there. If it was the default, the account has no default brand until another is chosen with `setDefaultBrand`. Analyzing its shop again and approving the result makes a new brand.\n\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "204": {
            "description": "Deleted"
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/brands/{brandId}/default": {
      "post": {
        "operationId": "setDefaultBrand",
        "tags": [
          "brands"
        ],
        "summary": "Make a brand the account's default",
        "description": "Makes the brand the account's default, the one runs use when they name no brand, and answers it. The brand that was the default stops being it.\n\n- **Retries:** making the default brand the default again changes nothing.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The default brand",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `brands.changed_meanwhile`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.changed_meanwhile": {
                    "summary": "brands.changed_meanwhile",
                    "value": {
                      "code": "brands.changed_meanwhile",
                      "error": "The account's brands changed at the same moment; try again."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/brands/{brandId}/fonts/{role}": {
      "put": {
        "operationId": "attachBrandFont",
        "tags": [
          "brands"
        ],
        "summary": "Set a brand's heading or body font file",
        "description": "Sets the font file the brand's ads are set in for one role, `heading` or `body`, in place of the one it had, and answers the brand with its `fontFiles`. `asset` is the `{ key, mediaType }` of a font the account uploaded: a TTF or OTF file, which must be uploaded first. A font the brand's profile names stays in the profile; this is the file itself. Editing the profile or approving a new analysis of the shop never changes the font files.\n\n- **Before:** upload the font with `startMediaUpload`, send the file's bytes and call `completeMediaUpload`; the answer's file is `asset`. The upload needs `licenceConfirmed: true`, which says the font's licence allows use in ads: an agent asks the user in the chat first and sets it only after an explicit yes. To use a Google font instead, call `importGoogleBrandFont`.\n- **Retries:** setting the same file again changes nothing.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The brand with its font files",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `brands.invalid_font`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.invalid_font": {
                    "summary": "brands.invalid_font",
                    "value": {
                      "code": "brands.invalid_font",
                      "error": "The font must be a TTF or OTF font file this account uploaded, ready to use."
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "role",
            "schema": {
              "type": "string",
              "enum": [
                "heading",
                "body"
              ]
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "asset": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                      },
                      "mediaType": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "key",
                      "mediaType"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "asset"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "brands:write"
      },
      "delete": {
        "operationId": "removeBrandFont",
        "tags": [
          "brands"
        ],
        "summary": "Remove a brand's heading or body font file",
        "description": "Clears the brand's font file of one role, `heading` or `body`, and answers the brand with its `fontFiles`. The brand's ads are set in the shipped font again; the uploaded file stays in the account's storage, out of the library. A role without a font file changes nothing.\n\n- **Retries:** removing it again changes nothing.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The brand without that font file",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "role",
            "schema": {
              "type": "string",
              "enum": [
                "heading",
                "body"
              ]
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/brands/{brandId}/fonts/{role}/google": {
      "post": {
        "operationId": "importGoogleBrandFont",
        "tags": [
          "brands"
        ],
        "summary": "Use a Google font as a brand's heading or body font file",
        "description": "Imports the Google Fonts file of the brand's font for one role, `heading` or `body`, and sets it as the role's font file in place of the one it had; answers the brand with its `fontFiles`. The family is the one in the brand's profile for that role when its source is `google`, else the nearest Google family the analysis found (`googleFamily`); a brand font with neither answers 409, and so does a family Google Fonts does not serve. The file is its TTF at the weight ads use for the role (900 for the heading, 700 for the body), or the nearest weight the family has. Google's families are under open licences that allow use in ads: no licence confirmation is needed. When Google Fonts cannot be reached the answer is 503 and nothing changes; try again later.\n\n- **Retries:** importing again replaces the file with the same one.\n- **Limits:** Each user or API key may call it 10 times a minute and 100 times a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n- **Credits:** none.\n\nNeeds an API key with the permission `brands:write`.",
        "responses": {
          "200": {
            "description": "The brand with its font files",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "shopId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "isDefault": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "tagline": {
                          "type": "string",
                          "maxLength": 120
                        },
                        "industry": {
                          "type": "string",
                          "enum": [
                            "home-and-living",
                            "appliances-and-electronics",
                            "skincare-and-beauty",
                            "fashion-and-apparel",
                            "sports-and-outdoor",
                            "jewelry-and-accessories",
                            "food-and-drink",
                            "kids-and-baby",
                            "pets",
                            "art-and-stationery",
                            "other"
                          ]
                        },
                        "language": {
                          "type": "string",
                          "maxLength": 35
                        },
                        "colors": {
                          "type": "object",
                          "properties": {
                            "primary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "secondary": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "accent": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "background": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "text": {
                              "type": "string",
                              "pattern": "^#[0-9a-f]{6}$"
                            },
                            "extra": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^#[0-9a-f]{6}$"
                              }
                            }
                          },
                          "required": [
                            "primary",
                            "secondary",
                            "accent",
                            "background",
                            "text",
                            "extra"
                          ]
                        },
                        "fonts": {
                          "type": "object",
                          "properties": {
                            "heading": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            },
                            "body": {
                              "type": "object",
                              "properties": {
                                "family": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "fallback": {
                                  "type": "string",
                                  "enum": [
                                    "serif",
                                    "sans-serif"
                                  ]
                                },
                                "source": {
                                  "type": "string",
                                  "enum": [
                                    "google",
                                    "shop"
                                  ]
                                },
                                "googleFamily": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "family",
                                "fallback",
                                "source"
                              ]
                            }
                          },
                          "required": [
                            "heading",
                            "body"
                          ]
                        },
                        "tone": {
                          "type": "object",
                          "properties": {
                            "summary": {
                              "type": "string",
                              "maxLength": 400
                            },
                            "keywords": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 30
                              }
                            },
                            "audience": {
                              "type": "string",
                              "maxLength": 160
                            }
                          },
                          "required": [
                            "summary",
                            "keywords",
                            "audience"
                          ]
                        },
                        "look": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "voice": {
                          "type": "string",
                          "maxLength": 600
                        },
                        "social": {
                          "maxItems": 9,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "platform": {
                                "type": "string",
                                "enum": [
                                  "instagram",
                                  "facebook",
                                  "tiktok",
                                  "pinterest",
                                  "youtube",
                                  "x",
                                  "linkedin",
                                  "threads",
                                  "bluesky"
                                ]
                              },
                              "handle": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 2048,
                                "format": "uri"
                              }
                            },
                            "required": [
                              "platform",
                              "handle",
                              "url"
                            ]
                          }
                        },
                        "logo": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        },
                        "icon": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                            },
                            "mediaType": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "key",
                            "mediaType"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "tagline",
                        "industry",
                        "language",
                        "colors",
                        "fonts",
                        "tone",
                        "look",
                        "voice",
                        "social"
                      ],
                      "additionalProperties": {}
                    },
                    "fontFiles": {
                      "default": {},
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        },
                        "body": {
                          "type": "object",
                          "properties": {
                            "asset": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1
                                }
                              },
                              "required": [
                                "key",
                                "mediaType"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "upload",
                                "google"
                              ]
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255
                            }
                          },
                          "required": [
                            "asset",
                            "source",
                            "name"
                          ]
                        }
                      }
                    },
                    "logoUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "iconUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "shopUrl": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "shopId",
                    "isDefault",
                    "profile",
                    "logoUrl",
                    "iconUrl",
                    "shopUrl",
                    "createdAt",
                    "updatedAt"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission brands:write.",
                      "details": {
                        "permission": "brands:write"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `brands.no_google_font`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "brands.no_google_font": {
                    "summary": "brands.no_google_font",
                    "value": {
                      "code": "brands.no_google_font",
                      "error": "The brand's body font has no Google Fonts family to import a font file from.",
                      "details": {
                        "role": "body"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "brandId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "role",
            "schema": {
              "type": "string",
              "enum": [
                "heading",
                "body"
              ]
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "brands:write"
      }
    },
    "/api/v1/orchestrator/runs": {
      "post": {
        "operationId": "startOrchestratorRun",
        "tags": [
          "orchestrator"
        ],
        "summary": "Run an Addon's Workflow",
        "description": "Starts the Addon's Workflow for the current account and answers at once; poll getOrchestratorRun until its status is no longer RUNNING. `inputs` are keyed by the Addon's input IDs and depend on the Addon; they are not described per Addon here. An input left out takes the value the account saved for the Addon (getAddonSettings), otherwise the Addon's default; an input given, null included, wins. An image or video input is the AssetRef of a ready asset the account stored (startMediaUpload) or a public https or data: URL. A `brand` input takes a brand's ID from listBrands, or `null` for no brand, never a brand's snapshot (400); left out, it takes the brand the account saved for the Addon, otherwise the account's default brand. An unknown brand ID answers 404 `not_found` and nothing starts. A `product` input takes `{ productId, variant?, image? }` from listProducts and getProduct (`variant` a variant's externalId, `image` a shop image's position), or `null`, never a product's snapshot (400); leave the photo input it fills out to start from the product's shop image at `image`, else the variant's first image, else the main image. An unknown product or variant answers 404 `not_found`; a shop image not loaded yet, failed or missing answers 409 `orchestrator.product_image_not_ready` with `details.position` and `details.state`, and nothing starts. When the run succeeds, its image and video outputs are linked to the product (or the variant) in getProduct. `maxCredits` is the most the run may cost: a higher price (computed from the Addon's `pricing` in listAddons and the inputs the run starts with, saved settings included) answers 409 `orchestrator.price_above_max_credits` with the price in `details.priceCredits` before anything starts. The run reserves its price before it starts and pays it only when it succeeds; an account without enough credits gets 409 `billing.insufficient_credits` with `details.required` and `details.available`, and nothing starts. An input the price depends on without a value the Addon prices answers 400 `orchestrator.input_not_priced`. `idempotencyKey` names one intended run: the same key within an hour answers the run it started (202, nothing starts again); with other `addonId`, `inputs` or `maxCredits` it answers 409 `orchestrator.idempotency_key_reused`, and while its first start is still on its way 409 `orchestrator.run_start_in_progress` with `details.retryAfterSeconds`. A start that ended without a run frees its key. An agent's or an account key's start needs both `maxCredits` and `idempotencyKey` (else 400). An account key's run uses each Addon's production version. A run counts as one item. Each user or API key may call it 10 times a minute and 200 items a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `runs:create`.",
        "responses": {
          "202": {
            "description": "The run has started",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "runId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The run ID. In the web app it is the run query parameter of the run page's URL."
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
                      "description": "The Addon ID. In the web app it is the id query parameter of the run page's URL.",
                      "examples": [
                        "lifestyle-scene"
                      ]
                    }
                  },
                  "required": [
                    "runId",
                    "addonId"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `orchestrator.input_not_priced`, `orchestrator.input_too_large`, `media.asset_not_ready`, `media.asset_ref_mismatch`, `media.unsupported_media_type`, `media.asset_type_mismatch`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.input_not_priced": {
                    "summary": "orchestrator.input_not_priced",
                    "value": {
                      "code": "orchestrator.input_not_priced",
                      "error": "The input size has no value this Addon has a price for",
                      "details": {
                        "inputId": "size"
                      }
                    }
                  },
                  "orchestrator.input_too_large": {
                    "summary": "orchestrator.input_too_large",
                    "value": {
                      "code": "orchestrator.input_too_large",
                      "error": "The run's inputs take 300000 bytes, more than the 262144 a run takes",
                      "details": {
                        "bytes": 300000,
                        "maxBytes": 262144
                      }
                    }
                  },
                  "media.asset_not_ready": {
                    "summary": "media.asset_not_ready",
                    "value": {
                      "code": "media.asset_not_ready",
                      "error": "The asset is pending: complete its upload before using it",
                      "details": {
                        "status": "pending"
                      }
                    }
                  },
                  "media.asset_ref_mismatch": {
                    "summary": "media.asset_ref_mismatch",
                    "value": {
                      "code": "media.asset_ref_mismatch",
                      "error": "The asset is image/jpeg, not image/png",
                      "details": {
                        "mediaType": "image/png",
                        "storedMediaType": "image/jpeg"
                      }
                    }
                  },
                  "media.unsupported_media_type": {
                    "summary": "media.unsupported_media_type",
                    "value": {
                      "code": "media.unsupported_media_type",
                      "error": "text/html is not an asset media type",
                      "details": {
                        "contentType": "text/html"
                      }
                    }
                  },
                  "media.asset_type_mismatch": {
                    "summary": "media.asset_type_mismatch",
                    "value": {
                      "code": "media.asset_type_mismatch",
                      "error": "image: video/mp4 is not an asset/image",
                      "details": {
                        "name": "image",
                        "mediaType": "video/mp4",
                        "type": "asset/image"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:create.",
                      "details": {
                        "permission": "runs:create"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Addon not found",
                      "details": {
                        "resource": "Addon"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.price_above_max_credits`, `billing.insufficient_credits`, `orchestrator.idempotency_key_reused`, `orchestrator.run_start_in_progress`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.price_above_max_credits": {
                    "summary": "orchestrator.price_above_max_credits",
                    "value": {
                      "code": "orchestrator.price_above_max_credits",
                      "error": "This run costs 12 credits, more than the 10 allowed",
                      "details": {
                        "priceCredits": 12,
                        "maxCredits": 10
                      }
                    }
                  },
                  "billing.insufficient_credits": {
                    "summary": "billing.insufficient_credits",
                    "value": {
                      "code": "billing.insufficient_credits",
                      "error": "This run needs 12 credits, but only 4 are available",
                      "details": {
                        "required": 12,
                        "available": 4
                      }
                    }
                  },
                  "orchestrator.idempotency_key_reused": {
                    "summary": "orchestrator.idempotency_key_reused",
                    "value": {
                      "code": "orchestrator.idempotency_key_reused",
                      "error": "This idempotency key already started another run; use a new key for a new run"
                    }
                  },
                  "orchestrator.run_start_in_progress": {
                    "summary": "orchestrator.run_start_in_progress",
                    "value": {
                      "code": "orchestrator.run_start_in_progress",
                      "error": "A start with this idempotency key is still on its way; ask again shortly",
                      "details": {
                        "retryAfterSeconds": 5
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "addonId": {
                    "type": "string",
                    "minLength": 1
                  },
                  "inputs": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "minLength": 1
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/__schema0"
                    }
                  },
                  "maxCredits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "idempotencyKey": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  }
                },
                "required": [
                  "addonId",
                  "inputs"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:create"
      }
    },
    "/api/v1/orchestrator/runs/{addonId}/{runId}/redo": {
      "post": {
        "operationId": "redoOrchestratorRun",
        "tags": [
          "orchestrator"
        ],
        "summary": "Make a finished run again with a note",
        "description": "Starts a finished run again as a new run, with the inputs it started with and a note of what to fix, and answers at once with the new run.\n\n- **Before:** only a SUCCEEDED run of an Addon whose form has `ui.redo` (listAddons), whose files are still there, can be redone; a batch's item is redone with redoOrchestratorBatch. `choices` are keys of the Addon's `ui.redo.choices`, `text` at most 300 characters in the user's words.\n- **Then:** follow the new run with getOrchestratorRun; its `redoOf` names the earlier run, which stays as it is.\n- **Credits:** the new run pays the Addon's price like any start, within `maxCredits`, and only when it succeeds.\n- **Retries:** `idempotencyKey` names one intended redo: the same key for the same run answers the run it started (202, nothing starts again), even with other `choices`, `text` or `maxCredits` and after the earlier run's files were deleted; for another run it is refused. An agent's or an API key's redo needs both `maxCredits` and `idempotencyKey`.\n- **API keys:** a key's redo runs each Addon's production version.\n- **Limits:** a redo counts as one start. Each user or API key may call it 10 times a minute and 200 items a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `runs:create`.",
        "responses": {
          "202": {
            "description": "The new run has started",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "runId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The run ID. In the web app it is the run query parameter of the run page's URL."
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
                      "description": "The Addon ID. In the web app it is the id query parameter of the run page's URL.",
                      "examples": [
                        "lifestyle-scene"
                      ]
                    }
                  },
                  "required": [
                    "runId",
                    "addonId"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `orchestrator.redo_choice_unknown`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.redo_choice_unknown": {
                    "summary": "orchestrator.redo_choice_unknown",
                    "value": {
                      "code": "orchestrator.redo_choice_unknown",
                      "error": "This Addon offers no redo choice \"brighter\"",
                      "details": {
                        "choice": "brighter"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:create.",
                      "details": {
                        "permission": "runs:create"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Run not found",
                      "details": {
                        "resource": "Run"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.run_not_redoable`, `orchestrator.price_above_max_credits`, `billing.insufficient_credits`, `orchestrator.idempotency_key_reused`, `orchestrator.run_start_in_progress`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.run_not_redoable": {
                    "summary": "orchestrator.run_not_redoable",
                    "value": {
                      "code": "orchestrator.run_not_redoable",
                      "error": "A file this run started with was deleted",
                      "details": {
                        "reason": "input_gone"
                      }
                    }
                  },
                  "orchestrator.price_above_max_credits": {
                    "summary": "orchestrator.price_above_max_credits",
                    "value": {
                      "code": "orchestrator.price_above_max_credits",
                      "error": "This run costs 10 credits, more than the 5 allowed",
                      "details": {
                        "priceCredits": 10,
                        "maxCredits": 5
                      }
                    }
                  },
                  "billing.insufficient_credits": {
                    "summary": "billing.insufficient_credits",
                    "value": {
                      "code": "billing.insufficient_credits",
                      "error": "This run needs 10 credits, but only 4 are available",
                      "details": {
                        "required": 10,
                        "available": 4
                      }
                    }
                  },
                  "orchestrator.idempotency_key_reused": {
                    "summary": "orchestrator.idempotency_key_reused",
                    "value": {
                      "code": "orchestrator.idempotency_key_reused",
                      "error": "This idempotency key already started another run; use a new key for a new run"
                    }
                  },
                  "orchestrator.run_start_in_progress": {
                    "summary": "orchestrator.run_start_in_progress",
                    "value": {
                      "code": "orchestrator.run_start_in_progress",
                      "error": "A start with this idempotency key is still on its way; ask again shortly",
                      "details": {
                        "retryAfterSeconds": 10
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "addonId",
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
            },
            "required": true,
            "description": "The Addon ID from the run page's id query parameter."
          },
          {
            "in": "path",
            "name": "runId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true,
            "description": "The run ID from the run page's run query parameter."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "choices": {
                    "description": "Keys of the Addon's redo choices (its manifest's ui.redo.choices) the user picked.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-zA-Z0-9]{0,31}$"
                    }
                  },
                  "text": {
                    "description": "What else to fix, in the user's words.",
                    "type": "string",
                    "maxLength": 300
                  },
                  "maxCredits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "idempotencyKey": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:create"
      }
    },
    "/api/v1/orchestrator/runs/history": {
      "get": {
        "operationId": "listOrchestratorRuns",
        "tags": [
          "orchestrator"
        ],
        "summary": "List your runs",
        "description": "Returns the account's runs, newest first, `limit` at a time (default 50, at most 100); pass `nextCursor` as `cursor` for the next page. `addonId` lists only that Addon's runs. A run a batch's item started names its `batchId`; `inBatch=false` leaves those out, as the web app's Addon page does next to listOrchestratorBatches, `inBatch=true` lists only them. A run's status is as last recorded; one that ended with an error names it and carries a `message` to tell the user. Call getOrchestratorRun with its addonId and runId for a run's live state and outputs.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "The runs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "runs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The run ID. In the web app it is the run query parameter of the run page's URL."
                          },
                          "addonId": {
                            "type": "string",
                            "maxLength": 32,
                            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
                            "description": "The Addon ID. In the web app it is the id query parameter of the run page's URL.",
                            "examples": [
                              "lifestyle-scene"
                            ]
                          },
                          "status": {
                            "type": "string"
                          },
                          "startedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "stoppedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "batchId": {
                            "description": "The batch whose item this run is, for getOrchestratorBatch; absent on a run started on its own.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          }
                        },
                        "required": [
                          "runId",
                          "addonId",
                          "status",
                          "startedAt"
                        ]
                      }
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "runs",
                    "nextCursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            }
          },
          {
            "in": "query",
            "name": "addonId",
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
            },
            "description": "Only runs of this Addon."
          },
          {
            "in": "query",
            "name": "inBatch",
            "schema": {
              "type": "string"
            },
            "description": "false: only runs started on their own, as the Addon page lists them next to its batches; true: only runs that items of batches started. Leave it out for both."
          }
        ],
        "x-ghostpull-permission": "runs:read"
      }
    },
    "/api/v1/orchestrator/runs/{addonId}/{runId}": {
      "get": {
        "operationId": "getOrchestratorRun",
        "tags": [
          "orchestrator"
        ],
        "summary": "Get a run's status and outputs",
        "description": "Reads a run started in the web app or a connected AI assistant: its status, original inputs and, once it succeeded, its outputs.\n\n- **IDs:** the run page's URL has them as its `id` and `run` query parameters.\n- **Polling:** pass `wait` (seconds, at most 15) and call again until `status` is no longer `RUNNING`; the call answers early when the run ends.\n- **Results:** `SUCCEEDED` has the final outputs. `FAILED`, `TIMED_OUT` and `ABORTED` end the run too, with `error` and, when available, a `message` safe to show.\n- **Progress:** while `RUNNING`, `steps` may carry progress, finished steps' outputs and labelled previews; an ended run has no `steps`.\n- **File URLs:** stored inputs and outputs may carry signed URLs that expire. Keep file keys or asset IDs and call again for fresh links.\n- **Credits:** none.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "The run",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "runId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The run ID. In the web app it is the run query parameter of the run page's URL."
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
                      "description": "The Addon ID. In the web app it is the id query parameter of the run page's URL.",
                      "examples": [
                        "lifestyle-scene"
                      ]
                    },
                    "status": {
                      "type": "string",
                      "description": "RUNNING, SUCCEEDED, FAILED, TIMED_OUT or ABORTED. Only RUNNING needs another poll; only SUCCEEDED has final outputs.",
                      "examples": [
                        "SUCCEEDED"
                      ]
                    },
                    "startedAt": {
                      "description": "When the run started, in UTC.",
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "stoppedAt": {
                      "description": "When the run ended, in UTC; absent while running.",
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "inputs": {
                      "description": "The inputs this run started with, by input ID. Ready stored files may include a short-lived download URL.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "anyOf": [
                          {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/image"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/png",
                                      "image/jpeg",
                                      "image/gif",
                                      "image/webp",
                                      "image/svg+xml"
                                    ]
                                  },
                                  "srcSet": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url",
                                        "width"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/video"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "video/mp4",
                                      "video/webm",
                                      "video/quicktime"
                                    ]
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/3d"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "model/gltf-binary",
                                      "model/gltf+json"
                                    ]
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/json"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "application/json"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/vector"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/svg+xml"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/font"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "font/ttf",
                                      "font/otf"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              }
                            ]
                          },
                          {
                            "$ref": "#/components/schemas/__schema0"
                          }
                        ]
                      }
                    },
                    "redoOf": {
                      "description": "Only on a run that redoes an earlier one with a note: that run's ID.",
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "outputs": {
                      "description": "Final outputs by name, only when SUCCEEDED. File outputs carry short-lived download URLs.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string",
                        "maxLength": 32,
                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                      },
                      "additionalProperties": {
                        "anyOf": [
                          {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/image"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/png",
                                      "image/jpeg",
                                      "image/gif",
                                      "image/webp",
                                      "image/svg+xml"
                                    ]
                                  },
                                  "srcSet": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "url": {
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "url",
                                        "width"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/video"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "width": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "height": {
                                    "examples": [
                                      1200
                                    ],
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "video/mp4",
                                      "video/webm",
                                      "video/quicktime"
                                    ]
                                  },
                                  "duration": {
                                    "type": "number",
                                    "exclusiveMinimum": 0
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/3d"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "model/gltf-binary",
                                      "model/gltf+json"
                                    ]
                                  },
                                  "thumbnail": {
                                    "type": "object",
                                    "properties": {
                                      "url": {
                                        "type": "string",
                                        "minLength": 1
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "url"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/json"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "application/json"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/vector"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "image/svg+xml"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "asset/font"
                                  },
                                  "url": {
                                    "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                    "examples": [
                                      "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "key": {
                                    "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                    "examples": [
                                      "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                    ],
                                    "type": "string",
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                  },
                                  "name": {
                                    "description": "The display name, such as the original file name.",
                                    "examples": [
                                      "shoe.png"
                                    ],
                                    "type": "string",
                                    "minLength": 1
                                  },
                                  "mediaType": {
                                    "type": "string",
                                    "enum": [
                                      "font/ttf",
                                      "font/otf"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ]
                              }
                            ]
                          },
                          {
                            "$ref": "#/components/schemas/__schema0"
                          }
                        ]
                      }
                    },
                    "libraryAssets": {
                      "description": "Only when SUCCEEDED: the media asset of each file output, by output name. Get it with getMediaAsset by id; editable marks an asset whose layers can be changed with the Addon that takes a composition input.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string",
                        "maxLength": 32,
                        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "editable": {
                            "type": "boolean",
                            "const": true
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "error": {
                      "description": "The error name of a failed run. Use message for text to show a person; the underlying cause is never returned.",
                      "examples": [
                        "Step.Failed"
                      ],
                      "type": "string"
                    },
                    "message": {
                      "description": "A safe explanation of why the run failed, suitable for showing to a person.",
                      "examples": [
                        "The model could not create the image. Try again."
                      ],
                      "type": "string"
                    },
                    "steps": {
                      "description": "Step progress while RUNNING, in workflow order. Absent on ended runs or when progress is temporarily unavailable; it is not a percentage or time estimate.",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "runId": {
                            "type": "string",
                            "minLength": 1
                          },
                          "stepId": {
                            "type": "string",
                            "minLength": 1
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "pending",
                              "running",
                              "waiting",
                              "succeeded",
                              "failed",
                              "skipped"
                            ]
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "attempt": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "round": {
                            "type": "integer",
                            "minimum": 2,
                            "maximum": 9007199254740991
                          },
                          "providerStatus": {
                            "type": "string"
                          },
                          "error": {
                            "type": "string"
                          },
                          "stage": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "minLength": 1
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1
                              },
                              "at": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              }
                            },
                            "required": [
                              "key",
                              "text",
                              "at"
                            ]
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "previews": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "output": {
                                  "type": "string",
                                  "maxLength": 32,
                                  "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              },
                              "required": [
                                "output",
                                "label"
                              ]
                            }
                          }
                        },
                        "required": [
                          "runId",
                          "stepId",
                          "status",
                          "at"
                        ]
                      }
                    }
                  },
                  "required": [
                    "runId",
                    "addonId",
                    "status"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Run not found",
                      "details": {
                        "resource": "Run"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "addonId",
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
            },
            "required": true,
            "description": "The Addon ID from the run page's id query parameter."
          },
          {
            "in": "path",
            "name": "runId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true,
            "description": "The run ID from the run page's run query parameter."
          },
          {
            "in": "query",
            "name": "wait",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 15
            },
            "description": "Wait up to this many seconds for a terminal status. Omit or use 0 to read immediately. Each poll counts as one API call."
          }
        ],
        "x-ghostpull-permission": "runs:read"
      }
    },
    "/api/v1/orchestrator/runs/{addonId}/{runId}/stream": {
      "get": {
        "operationId": "streamOrchestratorRun",
        "tags": [
          "orchestrator"
        ],
        "summary": "Follow a run's state as Server-Sent Events",
        "description": "Follows a run without polling: Server-Sent Events of its state, as `getOrchestratorRun` answers it.\n\n- **Events:** a `state` event at once, then again whenever the state changed while the run is `RUNNING`. Once the run is no longer `RUNNING`, the stream sends its state and closes.\n- **Connection:** a comment line every 20 s keeps it open. The stream closes after 15 minutes: reconnect to go on; the first event is the current state.\n- **Errors:** they answer as JSON before any event, such as 404 for a run of another account.\n- **Revoked keys:** an open stream outlives a revoked API key until it closes.\n- **Credits:** none.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "Server-Sent Events: each `state` event's data is the run's state as JSON (RunState, the getOrchestratorRun answer); lines starting with `:` are heartbeats",
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string",
                  "description": "Server-Sent Events: each `state` event's data is the run's state as JSON (RunState, the getOrchestratorRun answer); lines starting with `:` are heartbeats"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Run not found",
                      "details": {
                        "resource": "Run"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "addonId",
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
            },
            "required": true,
            "description": "The Addon ID from the run page's id query parameter."
          },
          {
            "in": "path",
            "name": "runId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true,
            "description": "The run ID from the run page's run query parameter."
          }
        ],
        "x-ghostpull-permission": "runs:read"
      }
    },
    "/api/v1/orchestrator/batches": {
      "get": {
        "operationId": "listOrchestratorBatches",
        "tags": [
          "orchestrator"
        ],
        "summary": "List your batches",
        "description": "Returns the account's batches from startOrchestratorBatch, newest first, `limit` at a time (default 50, at most 100); pass `nextCursor` as `cursor` for the next page. `addonId` lists only that Addon's batches. Each batch has its `itemCount` and `itemStatuses`, how many items are WAITING, RUNNING, SUCCEEDED, FAILED, TIMED_OUT, ABORTED or CANCELLED as last recorded, and is RUNNING while one waits or runs. Call getOrchestratorBatch with its batchId for its items, their results and live statuses; listOrchestratorRuns with `inBatch=false` lists the runs started on their own.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "The batches",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "batchId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "addonId": {
                            "type": "string",
                            "maxLength": 32,
                            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "RUNNING",
                              "ENDED"
                            ]
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "cancelledAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                          },
                          "itemCount": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "itemStatuses": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "enum": [
                                "WAITING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMED_OUT",
                                "ABORTED",
                                "CANCELLED"
                              ]
                            },
                            "additionalProperties": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "required": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          }
                        },
                        "required": [
                          "batchId",
                          "addonId",
                          "status",
                          "createdAt",
                          "itemCount",
                          "itemStatuses"
                        ]
                      }
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "batches",
                    "nextCursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "addonId",
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
            },
            "description": "Only batches of this Addon."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            }
          }
        ],
        "x-ghostpull-permission": "runs:read"
      },
      "post": {
        "operationId": "startOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Run an Addon on a set of items",
        "description": "Starts a batch: one run of the Addon per item, for example one per product photo, all with the same settings, and answers at once with its `batchId`.\n\n- **Inputs:** `inputs` are what every item's run takes, `items` up to 50 sets of each item's own inputs (for Catalog photo its `image`), both by the input IDs of the Addon's manifest (listAddons). An item's own inputs win; an input both leave out takes the value the account saved for the Addon (getAddonSettings), otherwise the Addon's default, as in startOrchestratorRun.\n- **Brand:** a `brand` input takes a brand's ID from listBrands, or `null` for no brand, never a brand's snapshot; left out, it takes the brand the account saved for the Addon, otherwise the account's default brand. It is read once when the batch starts, so a later edit of the brand changes none of its items. An unknown brand ID answers 404 `not_found` and nothing starts.\n- **Product:** a `product` input takes `{ productId, variant?, image? }`, one product per item, or `null`, never a product's snapshot. Each item reads its product once when the batch starts and, with its photo input left out, starts from the product's shop image as a run start does; an image not loaded yet, failed or missing refuses the batch with 400 `orchestrator.invalid_batch_item` naming the item, an unknown product or variant answers 404 `not_found`, and nothing starts. Each succeeded item's image and video outputs are linked to its product.\n- **Files:** an asset input takes an AssetRef of a ready file the account stored (startMediaUpload) or a public https URL, never a data: or other URL. A body over 256 KB is refused.\n- **Before:** every item, and the shared `inputs` on their own, are checked before any run starts: a value a run would refuse, or a URL that is not https, is refused with `details.issues` and either `details.index`, the item it is in, or `details.shared: true` when it is in `inputs` (the issues' paths are then within `inputs`). Nothing starts then.\n- **Then:** at most 5 of the batch's runs go at once; the next starts when one ends, and an item whose run fails does not stop the others. Follow the batch with getOrchestratorBatch or streamOrchestratorBatch.\n- **Credits:** each item's run costs its own price, from the Addon's `pricing` in listAddons and the inputs it starts with, saved settings included; it reserves the price when it starts and pays only when it succeeds. `maxCredits` is the most each item's run may cost; a higher price is refused. A batch whose runs together cost more than the account can spend now is refused with `details.required` and `details.available`, and nothing starts; an item whose run cannot reserve its price later fails with that message, and the others go on.\n- **Retries:** `idempotencyKey` names one intended batch: the same key again answers the batch it started (202, nothing starts again) and is refused with another request. An agent's or an API key's start needs both `maxCredits` and `idempotencyKey`.\n- **API keys:** a key's batch runs each Addon's production version. Once the key is revoked, expires or loses `runs:create`, its items that have not started end without starting, with the error `Batch.KeyRevoked`; its started runs go on.\n- **Limits:** a batch counts as one start a minute and as one start per item a day against startOrchestratorRun's limit: Each user or API key may call it 10 times a minute and 200 items a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `runs:create`.",
        "responses": {
          "202": {
            "description": "The batch has started",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `orchestrator.invalid_batch_item`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.invalid_batch_item": {
                    "summary": "orchestrator.invalid_batch_item",
                    "value": {
                      "code": "orchestrator.invalid_batch_item",
                      "error": "Item 2 of the batch has inputs the Addon does not take",
                      "details": {
                        "index": 2,
                        "issues": [
                          {
                            "path": [
                              "image"
                            ],
                            "message": "Invalid input"
                          }
                        ]
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:create.",
                      "details": {
                        "permission": "runs:create"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Addon not found",
                      "details": {
                        "resource": "Addon"
                      }
                    }
                  },
                  "not_found_1": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Brand not found",
                      "details": {
                        "resource": "Brand"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.price_above_max_credits`, `billing.insufficient_credits`, `orchestrator.batch_idempotency_key_reused`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.price_above_max_credits": {
                    "summary": "orchestrator.price_above_max_credits",
                    "value": {
                      "code": "orchestrator.price_above_max_credits",
                      "error": "This run costs 12 credits, more than the 10 allowed",
                      "details": {
                        "priceCredits": 12,
                        "maxCredits": 10
                      }
                    }
                  },
                  "billing.insufficient_credits": {
                    "summary": "billing.insufficient_credits",
                    "value": {
                      "code": "billing.insufficient_credits",
                      "error": "This batch needs 60 credits, but only 30 are available",
                      "details": {
                        "required": 60,
                        "available": 30
                      }
                    }
                  },
                  "orchestrator.batch_idempotency_key_reused": {
                    "summary": "orchestrator.batch_idempotency_key_reused",
                    "value": {
                      "code": "orchestrator.batch_idempotency_key_reused",
                      "error": "This idempotency key already started another batch; use a new key for a new batch"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Request body too large: `request_too_large`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "request_too_large": {
                    "summary": "request_too_large",
                    "value": {
                      "code": "request_too_large",
                      "error": "The request body exceeds 262144 bytes",
                      "details": {
                        "maxBytes": 262144
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "addonId": {
                    "type": "string",
                    "minLength": 1
                  },
                  "inputs": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "minLength": 1
                    },
                    "additionalProperties": {
                      "$ref": "#/components/schemas/__schema0"
                    },
                    "description": "Inputs every item's run takes, by input id: values, and for an asset input an AssetRef of a stored file or a public https URL, never a data: or other URL; an item's own inputs win."
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inputs": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1
                          },
                          "additionalProperties": {
                            "$ref": "#/components/schemas/__schema0"
                          },
                          "description": "This item's own inputs, for example its photo, taken as `inputs` takes them."
                        }
                      },
                      "required": [
                        "inputs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "maxCredits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "idempotencyKey": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255
                  }
                },
                "required": [
                  "addonId",
                  "inputs",
                  "items"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:create"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}": {
      "get": {
        "operationId": "getOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Get a batch's items and their results",
        "description": "Returns where a batch from startOrchestratorBatch stands: `RUNNING` while an item waits or runs, `ENDED` once none does, with every item and its result.\n\n- **Items:** each has its `index` in the start's items, its own `inputs` by input ID and a status: `WAITING` for a free place, `RUNNING`, `SUCCEEDED` with its `outputs`, `FAILED`, `TIMED_OUT` or `ABORTED` with `error` and a `message` safe to show, or `CANCELLED`. A started item names its `runId` for getOrchestratorRun.\n- **Polling:** call again every 20 seconds or so while the batch is `RUNNING`, or follow it with streamOrchestratorBatch.\n- **Then:** `FAILED` and `TIMED_OUT` items can be started again with retryOrchestratorBatch.\n- **File URLs:** stored inputs and outputs carry signed URLs that expire after 15 minutes. Keep file keys or asset IDs and call again for fresh links.\n- **Credits:** none.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "The batch",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "RUNNING",
                        "ENDED"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "cancelledAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "index": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          },
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "retriable": {
                            "description": "On a FAILED or TIMED_OUT item: whether retryOrchestratorBatch would start it again. False when its own inputs caused the error, so the same inputs would fail again.",
                            "type": "boolean"
                          },
                          "chosenRunId": {
                            "description": "After a redo: the run whose result this item shows, its newest or its previous one; setOrchestratorBatchItemVersion changes it.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "previousRunId": {
                            "description": "After a redo: the version kept beside the newest one, the one shown when the redo started.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "inputs": {
                            "description": "This item's own inputs, by input ID, for example its photo. Stored files include a short-lived download URL.",
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "index",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId",
                    "status",
                    "createdAt",
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "runs:read"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}/stream": {
      "get": {
        "operationId": "streamOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Follow a batch's state as Server-Sent Events",
        "description": "Follows a batch without polling: Server-Sent Events of its state, as getOrchestratorBatch answers it.\n\n- **Events:** a `state` event at once, then again whenever the state changed while the batch is `RUNNING`. Once it `ENDED`, the stream sends its state and closes.\n- **Connection:** a comment line every 20 s keeps it open. The stream closes after 15 minutes: reconnect to go on; the first event is the current state.\n- **Errors:** they answer as JSON before any event, such as 404 for a batch of another account.\n- **Revoked keys:** an open stream outlives a revoked API key until it closes.\n- **Credits:** none.\n\nNeeds an API key with the permission `runs:read`.",
        "responses": {
          "200": {
            "description": "Server-Sent Events: each `state` event's data is the batch's state as JSON (BatchState, the getOrchestratorBatch answer); lines starting with `:` are heartbeats",
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string",
                  "description": "Server-Sent Events: each `state` event's data is the batch's state as JSON (BatchState, the getOrchestratorBatch answer); lines starting with `:` are heartbeats"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:read.",
                      "details": {
                        "permission": "runs:read"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "runs:read"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}/cancel": {
      "post": {
        "operationId": "cancelOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Cancel a batch",
        "description": "Cancels a batch from startOrchestratorBatch and answers it as getOrchestratorBatch does.\n\n- **Items:** waiting items never start and become `CANCELLED`; running runs are stopped and end `ABORTED`, and may still show `RUNNING` for a few seconds. Items that ended keep their results.\n- **Retries:** a batch whose items all ended stays as it is. Cancelling again stops what still runs and changes nothing else; a cancelled batch cannot be retried.\n- **Credits:** none; stopped runs pay nothing.\n\nNeeds an API key with the permission `runs:manage`.",
        "responses": {
          "200": {
            "description": "The batch after the cancel",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "RUNNING",
                        "ENDED"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "cancelledAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "index": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          },
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "retriable": {
                            "description": "On a FAILED or TIMED_OUT item: whether retryOrchestratorBatch would start it again. False when its own inputs caused the error, so the same inputs would fail again.",
                            "type": "boolean"
                          },
                          "chosenRunId": {
                            "description": "After a redo: the run whose result this item shows, its newest or its previous one; setOrchestratorBatchItemVersion changes it.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "previousRunId": {
                            "description": "After a redo: the version kept beside the newest one, the one shown when the redo started.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "inputs": {
                            "description": "This item's own inputs, by input ID, for example its photo. Stored files include a short-lived download URL.",
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "index",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId",
                    "status",
                    "createdAt",
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:manage.",
                      "details": {
                        "permission": "runs:manage"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "x-ghostpull-permission": "runs:manage"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}/retry": {
      "post": {
        "operationId": "retryOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Retry a batch's failed items",
        "description": "Starts the `FAILED` and `TIMED_OUT` items of a batch from startOrchestratorBatch again, in the same batch and place, each as a new run, and answers the batch as getOrchestratorBatch does.\n\n- **Items:** `items` names them by index; leave it out (send `{}`) for every such item. An item whose own inputs caused its error (`retriable` false, such as a photo the Addon cannot use) would fail again and is left out. With no failed item nothing changes.\n- **Then:** the batch is `RUNNING` again, at most 5 of its runs at once. An item's earlier run stays readable with getOrchestratorRun; its `runId` names the new run once it started.\n- **Before:** a named item that is not `FAILED` or `TIMED_OUT`, or not retriable, a cancelled batch, a batch whose API key was revoked, and items whose runs together cost more than the account can spend now are refused, and nothing starts.\n- **Credits:** each new run costs the Addon's price, within the batch's `maxCredits`, and pays only when it succeeds.\n- **Limits:** a retry counts as one start a minute and as one start per retried item a day against startOrchestratorRun's limit: Each user or API key may call it 10 times a minute and 200 items a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `runs:manage`.",
        "responses": {
          "202": {
            "description": "The batch after the retry",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "RUNNING",
                        "ENDED"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "cancelledAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "index": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          },
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "retriable": {
                            "description": "On a FAILED or TIMED_OUT item: whether retryOrchestratorBatch would start it again. False when its own inputs caused the error, so the same inputs would fail again.",
                            "type": "boolean"
                          },
                          "chosenRunId": {
                            "description": "After a redo: the run whose result this item shows, its newest or its previous one; setOrchestratorBatchItemVersion changes it.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "previousRunId": {
                            "description": "After a redo: the version kept beside the newest one, the one shown when the redo started.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "inputs": {
                            "description": "This item's own inputs, by input ID, for example its photo. Stored files include a short-lived download URL.",
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "index",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId",
                    "status",
                    "createdAt",
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:manage.",
                      "details": {
                        "permission": "runs:manage"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.batch_cancelled`, `orchestrator.batch_key_revoked`, `orchestrator.batch_item_not_retriable`, `billing.insufficient_credits`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.batch_cancelled": {
                    "summary": "orchestrator.batch_cancelled",
                    "value": {
                      "code": "orchestrator.batch_cancelled",
                      "error": "This batch was cancelled, so its items cannot be retried or redone; start a new batch for them"
                    }
                  },
                  "orchestrator.batch_key_revoked": {
                    "summary": "orchestrator.batch_key_revoked",
                    "value": {
                      "code": "orchestrator.batch_key_revoked",
                      "error": "The API key that started this batch was revoked, has expired or may no longer start runs, so its items cannot be retried or redone; start a new batch for them"
                    }
                  },
                  "orchestrator.batch_item_not_retriable": {
                    "summary": "orchestrator.batch_item_not_retriable",
                    "value": {
                      "code": "orchestrator.batch_item_not_retriable",
                      "error": "Item 3 of the batch is SUCCEEDED; only FAILED and TIMED_OUT items can be retried",
                      "details": {
                        "index": 3,
                        "status": "SUCCEEDED"
                      }
                    }
                  },
                  "billing.insufficient_credits": {
                    "summary": "billing.insufficient_credits",
                    "value": {
                      "code": "billing.insufficient_credits",
                      "error": "This batch needs 60 credits, but only 30 are available",
                      "details": {
                        "required": 60,
                        "available": 30
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "description": "The indexes of the items to retry, each FAILED or TIMED_OUT; leave it out to retry every such item.",
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    }
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:manage"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}/redo": {
      "post": {
        "operationId": "redoOrchestratorBatch",
        "tags": [
          "orchestrator"
        ],
        "summary": "Make finished items of a batch again with a note",
        "description": "Makes SUCCEEDED items of a batch from startOrchestratorBatch again with a note of what to fix, in the same batch and place, also while the batch runs, and answers the batch as getOrchestratorBatch does.\n\n- **Items:** `items` names them by index, each with `choices` (keys of the Addon's `ui.redo.choices` in listAddons) and `text` (at most 300 characters, in the user's words). Or send `{ \"needsReview\": true }` to redo every SUCCEEDED item whose result failed checks that are among `ui.redo.choices`, each with those checks as its choices; an item whose review note names no such check is left out. With no item to redo nothing changes.\n- **Then:** each item starts again as a new run with the inputs the batch started with, at most 5 of the batch's runs at once. The version an item showed stays as its `previousRunId`; once the new run SUCCEEDED the item shows it, until setOrchestratorBatchItemVersion picks the other one.\n- **Before:** a named item that did not succeed, an Addon without `ui.redo`, an item whose file was deleted, a cancelled batch, a batch whose API key was revoked, and items whose runs together cost more than the account can spend now are refused, and nothing starts.\n- **Credits:** each new run costs the Addon's price, within the batch's `maxCredits`, and pays only when it succeeds.\n- **Limits:** a redo counts as one start a minute and as one start per redone item a day against startOrchestratorRun's limit: Each user or API key may call it 10 times a minute and 200 items a day; after that it answers 429 with `Retry-After` and `details.retryAfterSeconds`, the seconds to wait before calling again.\n\nNeeds an API key with the permission `runs:manage`.",
        "responses": {
          "202": {
            "description": "The batch after the redo",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "RUNNING",
                        "ENDED"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "cancelledAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "index": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          },
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "retriable": {
                            "description": "On a FAILED or TIMED_OUT item: whether retryOrchestratorBatch would start it again. False when its own inputs caused the error, so the same inputs would fail again.",
                            "type": "boolean"
                          },
                          "chosenRunId": {
                            "description": "After a redo: the run whose result this item shows, its newest or its previous one; setOrchestratorBatchItemVersion changes it.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "previousRunId": {
                            "description": "After a redo: the version kept beside the newest one, the one shown when the redo started.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "inputs": {
                            "description": "This item's own inputs, by input ID, for example its photo. Stored files include a short-lived download URL.",
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "index",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId",
                    "status",
                    "createdAt",
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `orchestrator.redo_choice_unknown`, `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.redo_choice_unknown": {
                    "summary": "orchestrator.redo_choice_unknown",
                    "value": {
                      "code": "orchestrator.redo_choice_unknown",
                      "error": "This Addon offers no redo choice \"brighter\"",
                      "details": {
                        "choice": "brighter"
                      }
                    }
                  },
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:manage.",
                      "details": {
                        "permission": "runs:manage"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.batch_cancelled`, `orchestrator.batch_key_revoked`, `orchestrator.batch_item_not_redoable`, `orchestrator.price_above_max_credits`, `billing.insufficient_credits`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.batch_cancelled": {
                    "summary": "orchestrator.batch_cancelled",
                    "value": {
                      "code": "orchestrator.batch_cancelled",
                      "error": "This batch was cancelled, so its items cannot be retried or redone; start a new batch for them"
                    }
                  },
                  "orchestrator.batch_key_revoked": {
                    "summary": "orchestrator.batch_key_revoked",
                    "value": {
                      "code": "orchestrator.batch_key_revoked",
                      "error": "The API key that started this batch was revoked, has expired or may no longer start runs, so its items cannot be retried or redone; start a new batch for them"
                    }
                  },
                  "orchestrator.batch_item_not_redoable": {
                    "summary": "orchestrator.batch_item_not_redoable",
                    "value": {
                      "code": "orchestrator.batch_item_not_redoable",
                      "error": "Item 3 is FAILED; only an item that shows a result that succeeded can be redone",
                      "details": {
                        "index": 3,
                        "status": "FAILED"
                      }
                    }
                  },
                  "orchestrator.price_above_max_credits": {
                    "summary": "orchestrator.price_above_max_credits",
                    "value": {
                      "code": "orchestrator.price_above_max_credits",
                      "error": "This run costs 10 credits, more than the 5 allowed",
                      "details": {
                        "priceCredits": 10,
                        "maxCredits": 5
                      }
                    }
                  },
                  "billing.insufficient_credits": {
                    "summary": "billing.insufficient_credits",
                    "value": {
                      "code": "billing.insufficient_credits",
                      "error": "This batch needs 60 credits, but only 30 are available",
                      "details": {
                        "required": 60,
                        "available": 30
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "items": {
                        "minItems": 1,
                        "maxItems": 50,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "index": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "choices": {
                              "description": "Keys of the Addon's redo choices (its manifest's ui.redo.choices) the user picked.",
                              "maxItems": 10,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[a-z][a-zA-Z0-9]{0,31}$"
                              }
                            },
                            "text": {
                              "description": "What else to fix, in the user's words.",
                              "type": "string",
                              "maxLength": 300
                            }
                          },
                          "required": [
                            "index"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "items"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "needsReview": {
                        "type": "boolean",
                        "const": true
                      }
                    },
                    "required": [
                      "needsReview"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:manage"
      }
    },
    "/api/v1/orchestrator/batches/{batchId}/items/{index}/choice": {
      "put": {
        "operationId": "setOrchestratorBatchItemVersion",
        "tags": [
          "orchestrator"
        ],
        "summary": "Choose which version a redone batch item shows",
        "description": "Chooses which of a redone batch item's two versions it shows, and answers the batch as getOrchestratorBatch does.\n\n- **Before:** after redoOrchestratorBatch an item has its newest run (`runId`) and the one it showed before the redo (`previousRunId`). `runId` must be one of the two and must have SUCCEEDED.\n- **Then:** the item shows that run's outputs in getOrchestratorBatch, in every tab and in the batch's download. The other run stays readable with getOrchestratorRun and in the media library.\n- **Credits:** none.\n\nNeeds an API key with the permission `runs:manage`.",
        "responses": {
          "200": {
            "description": "The batch with the chosen version",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "batchId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "addonId": {
                      "type": "string",
                      "maxLength": 32,
                      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "RUNNING",
                        "ENDED"
                      ]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "cancelledAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "index": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "WAITING",
                              "RUNNING",
                              "SUCCEEDED",
                              "FAILED",
                              "TIMED_OUT",
                              "ABORTED",
                              "CANCELLED"
                            ]
                          },
                          "runId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "outputs": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string",
                              "maxLength": 32,
                              "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          },
                          "error": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          },
                          "retriable": {
                            "description": "On a FAILED or TIMED_OUT item: whether retryOrchestratorBatch would start it again. False when its own inputs caused the error, so the same inputs would fail again.",
                            "type": "boolean"
                          },
                          "chosenRunId": {
                            "description": "After a redo: the run whose result this item shows, its newest or its previous one; setOrchestratorBatchItemVersion changes it.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "previousRunId": {
                            "description": "After a redo: the version kept beside the newest one, the one shown when the redo started.",
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "inputs": {
                            "description": "This item's own inputs, by input ID, for example its photo. Stored files include a short-lived download URL.",
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/image"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/png",
                                            "image/jpeg",
                                            "image/gif",
                                            "image/webp",
                                            "image/svg+xml"
                                          ]
                                        },
                                        "srcSet": {
                                          "minItems": 1,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "width": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "width"
                                            ]
                                          }
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/video"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "width": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "height": {
                                          "examples": [
                                            1200
                                          ],
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "video/mp4",
                                            "video/webm",
                                            "video/quicktime"
                                          ]
                                        },
                                        "duration": {
                                          "type": "number",
                                          "exclusiveMinimum": 0
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/3d"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "model/gltf-binary",
                                            "model/gltf+json"
                                          ]
                                        },
                                        "thumbnail": {
                                          "type": "object",
                                          "properties": {
                                            "url": {
                                              "type": "string",
                                              "minLength": 1
                                            },
                                            "width": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "height": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "url"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/json"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "application/json"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/vector"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "image/svg+xml"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "asset/font"
                                        },
                                        "url": {
                                          "description": "A URL for viewing or downloading the file. URLs returned by the API are signed and expire; keep the asset ID or storage key instead.",
                                          "examples": [
                                            "https://cdn.ghostpull.example/library/shoe.png?Expires=1793110800&Signature=…"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "key": {
                                          "description": "The stored version's key, not a URL. Together with mediaType it identifies the file for a run.",
                                          "examples": [
                                            "accounts/9a2b3c4d-5e6f-4a1b-8c2d-3e4f5a6b7c8d/assets/3f1c9a52-7d4e-4b8a-9c21-5e6f7a8b9c0d/versions/7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f"
                                          ],
                                          "type": "string",
                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-/]*$"
                                        },
                                        "name": {
                                          "description": "The display name, such as the original file name.",
                                          "examples": [
                                            "shoe.png"
                                          ],
                                          "type": "string",
                                          "minLength": 1
                                        },
                                        "mediaType": {
                                          "type": "string",
                                          "enum": [
                                            "font/ttf",
                                            "font/otf"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ]
                                    }
                                  ]
                                },
                                {
                                  "$ref": "#/components/schemas/__schema0"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "index",
                          "status"
                        ]
                      }
                    }
                  },
                  "required": [
                    "batchId",
                    "addonId",
                    "status",
                    "createdAt",
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: `invalid_request`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "summary": "invalid_request",
                    "value": {
                      "code": "invalid_request",
                      "error": "Invalid request",
                      "issues": [
                        {
                          "origin": "string",
                          "code": "too_small",
                          "minimum": 1,
                          "inclusive": true,
                          "path": [
                            "name"
                          ],
                          "message": "Too small: expected string to have >=1 characters"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated: `identity.unauthenticated`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.unauthenticated": {
                    "summary": "identity.unauthenticated",
                    "value": {
                      "code": "identity.unauthenticated",
                      "error": "Authentication required"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Not allowed: `identity.missing_permission`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.missing_permission": {
                    "summary": "identity.missing_permission",
                    "value": {
                      "code": "identity.missing_permission",
                      "error": "This API key needs the permission runs:manage.",
                      "details": {
                        "permission": "runs:manage"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found: `not_found`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "not_found",
                    "value": {
                      "code": "not_found",
                      "error": "Batch not found",
                      "details": {
                        "resource": "Batch"
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict: `orchestrator.batch_version_not_choosable`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "orchestrator.batch_version_not_choosable": {
                    "summary": "orchestrator.batch_version_not_choosable",
                    "value": {
                      "code": "orchestrator.batch_version_not_choosable",
                      "error": "Run 01a15edb-0000-7000-8000-000000000004 is no version of item 3 that succeeded; choose its newest or previous run",
                      "details": {
                        "index": 3,
                        "runId": "01a15edb-0000-7000-8000-000000000004"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests: `identity.too_many_requests`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.too_many_requests": {
                    "summary": "identity.too_many_requests",
                    "value": {
                      "code": "identity.too_many_requests",
                      "error": "Too many requests. Try again in 42 seconds.",
                      "details": {
                        "retryAfterSeconds": 42
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable: `identity.api_key_check_failed`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "identity.api_key_check_failed": {
                    "summary": "identity.api_key_check_failed",
                    "value": {
                      "code": "identity.api_key_check_failed",
                      "error": "The API key could not be checked. Try again shortly."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "batchId",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "index",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "required": true,
            "description": "The item's index in the batch, from getOrchestratorBatch."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "runId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  }
                },
                "required": [
                  "runId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "x-ghostpull-permission": "runs:manage"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "An account API key, created in the web app under Settings › API keys. Only the operations that list it take it, and only with the permission each names."
      }
    },
    "schemas": {
      "__schema0": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          },
          {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/__schema0"
            }
          },
          {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "$ref": "#/components/schemas/__schema0"
            }
          }
        ]
      },
      "Error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "details": {},
          "issues": {
            "type": "array",
            "items": {}
          }
        },
        "required": [
          "code",
          "error"
        ]
      }
    }
  }
}
