From d1b8ef119dbe7030f8f2674cfebca00f74937a58 Mon Sep 17 00:00:00 2001
From: dazzatronus <derkzomer@gmail.com>
Date: Mon, 18 May 2026 13:46:34 +1000
Subject: [PATCH] feat: add optional client-generated identifier to Clip schema

---
 schemas/clip.yaml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/schemas/clip.yaml b/schemas/clip.yaml
index fe0ebec..9ced879 100644
--- a/schemas/clip.yaml
+++ b/schemas/clip.yaml
@@ -5,6 +5,14 @@
         timeline, how long it will play for and transitions, filters and effects to apply
         to it.
       properties:
+        id:
+          description: >-
+            Optional client-generated identifier. Used by client SDKs
+            (e.g. the Shotstack Studio SDK) to reference a clip across edits
+            without relying on its position in the timeline. The render API
+            does not use this field and it does not appear in render output.
+          type: string
+          example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
         asset:
           $ref: "./asset.yaml#/Asset"
         start: