/brands/:id/versions/:versionId/restore
/api/v1/brands/{id}/versions/{versionId}/restore - POST
POST
/api/v1/brands/{id}/versions/{versionId}/restorePath Parameters
id*string
Format
uuidversionId*string
Format
uuidResponse Body
application/json
application/json
curl -X POST "https://example.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/497f6eca-6276-4993-bfeb-53cbbbba6f08/restore"{ "id": "4a01a492-f21b-4cad-9836-910ec06f6e26", "organizationId": "4a01a492-f21b-4cad-9836-910ec06f6e26", "createdByUserId": "4a01a492-f21b-4cad-9836-910ec06f6e26", "name": "string", "domain": "string", "status": "draft", "document": { "$schema": "https://www.designtokens.org/schemas/2025.10/format.json", "color": { "light": { "primary": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "secondary": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "accent": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "background": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "surface": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "text": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "textMuted": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "$extensions": { "property1": null, "property2": null } }, "dark": { "primary": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "secondary": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "accent": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "background": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "surface": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "text": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "textMuted": { "$type": "color", "$value": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "$extensions": { "property1": null, "property2": null } }, "$extensions": { "property1": null, "property2": null } }, "gradient": { "property1": { "$type": "gradient", "$value": [ { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "position": 0 }, { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "position": 0 } ], "$description": "string", "$extensions": { "property1": null, "property2": null } }, "property2": { "$type": "gradient", "$value": [ { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "position": 0 }, { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "position": 0 } ], "$description": "string", "$extensions": { "property1": null, "property2": null } } }, "font": { "display": { "$type": "fontFamily", "$value": [ "string" ], "$description": "string", "$extensions": { "studio.fontRole": { "weights": { "regular": 1, "medium": 1, "bold": 1 }, "letterSpacing": "string", "files": [ { "$asset": "string", "variable": true, "weight": 1, "weightRange": [ 1, 1000 ], "style": "normal", "format": "woff2" } ] } } }, "heading": { "$type": "fontFamily", "$value": [ "string" ], "$description": "string", "$extensions": { "studio.fontRole": { "weights": { "regular": 1, "medium": 1, "bold": 1 }, "letterSpacing": "string", "files": [ { "$asset": "string", "variable": true, "weight": 1, "weightRange": [ 1, 1000 ], "style": "normal", "format": "woff2" } ] } } }, "body": { "$type": "fontFamily", "$value": [ "string" ], "$description": "string", "$extensions": { "studio.fontRole": { "weights": { "regular": 1, "medium": 1, "bold": 1 }, "letterSpacing": "string", "files": [ { "$asset": "string", "variable": true, "weight": 1, "weightRange": [ 1, 1000 ], "style": "normal", "format": "woff2" } ] } } }, "mono": { "$type": "fontFamily", "$value": [ "string" ], "$description": "string", "$extensions": { "studio.fontRole": { "weights": { "regular": 1, "medium": 1, "bold": 1 }, "letterSpacing": "string", "files": [ { "$asset": "string", "variable": true, "weight": 1, "weightRange": [ 1, 1000 ], "style": "normal", "format": "woff2" } ] } } }, "$extensions": { "property1": null, "property2": null } }, "radius": { "sm": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "md": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lg": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "xl": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "$extensions": { "property1": null, "property2": null } }, "space": { "xs": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "sm": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "md": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lg": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "xl": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "$extensions": { "studio.density": "compact" } }, "border": { "width": { "subtle": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "default": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "strong": { "$type": "dimension", "$value": { "value": 0, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } } }, "style": { "subtle": { "$type": "strokeStyle", "$value": "none", "$description": "string", "$extensions": { "property1": null, "property2": null } }, "default": { "$type": "strokeStyle", "$value": "none", "$description": "string", "$extensions": { "property1": null, "property2": null } }, "strong": { "$type": "strokeStyle", "$value": "none", "$description": "string", "$extensions": { "property1": null, "property2": null } } } }, "elevation": { "sm": { "$type": "shadow", "$value": [ { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "offsetX": { "value": -1.7976931348623157e+308, "unit": "px" }, "offsetY": { "value": -1.7976931348623157e+308, "unit": "px" }, "blur": { "value": 0, "unit": "px" }, "spread": { "value": -1.7976931348623157e+308, "unit": "px" } } ], "$description": "string", "$extensions": { "property1": null, "property2": null } }, "md": { "$type": "shadow", "$value": [ { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "offsetX": { "value": -1.7976931348623157e+308, "unit": "px" }, "offsetY": { "value": -1.7976931348623157e+308, "unit": "px" }, "blur": { "value": 0, "unit": "px" }, "spread": { "value": -1.7976931348623157e+308, "unit": "px" } } ], "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lg": { "$type": "shadow", "$value": [ { "color": { "colorSpace": "srgb", "components": [ 0 ], "alpha": 0, "hex": "string" }, "offsetX": { "value": -1.7976931348623157e+308, "unit": "px" }, "offsetY": { "value": -1.7976931348623157e+308, "unit": "px" }, "blur": { "value": 0, "unit": "px" }, "spread": { "value": -1.7976931348623157e+308, "unit": "px" } } ], "$description": "string", "$extensions": { "property1": null, "property2": null } } }, "typographyMeta": { "display": { "family": "display", "size": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lineHeight": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "letterSpacing": { "$type": "dimension", "$value": { "value": -1.7976931348623157e+308, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "weight": 1, "transform": "none" }, "h1": { "family": "display", "size": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lineHeight": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "letterSpacing": { "$type": "dimension", "$value": { "value": -1.7976931348623157e+308, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "weight": 1, "transform": "none" }, "h2": { "family": "display", "size": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lineHeight": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "letterSpacing": { "$type": "dimension", "$value": { "value": -1.7976931348623157e+308, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "weight": 1, "transform": "none" }, "body": { "family": "display", "size": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lineHeight": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "letterSpacing": { "$type": "dimension", "$value": { "value": -1.7976931348623157e+308, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "weight": 1, "transform": "none" }, "caption": { "family": "display", "size": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "lineHeight": { "$type": "dimension", "$value": { "value": 1, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "letterSpacing": { "$type": "dimension", "$value": { "value": -1.7976931348623157e+308, "unit": "px" }, "$description": "string", "$extensions": { "property1": null, "property2": null } }, "weight": 1, "transform": "none" } }, "$extensions": { "studio.schemaVersion": 3, "studio.modes": { "available": "light", "default": "light" }, "studio.identity": { "name": "string", "domain": "string", "tagline": "string", "description": "string", "tone": [], "audience": "string", "terminology": { "preferred": [ "string" ], "banned": [ "string" ] }, "quotes": [ { "text": "string", "author": "string", "role": "string", "company": "string" } ], "customers": [ { "name": "string", "logo": { "$asset": "string" } } ], "metrics": [ { "label": "string", "value": "string", "source": "string" } ], "socials": [ { "type": "x", "url": "string" } ] }, "studio.typography": { "scale": { "display": 1, "h1": 1, "h2": 1, "body": 1, "caption": 1 }, "case": { "eyebrow": "uppercase", "headings": "sentence" } }, "studio.logos": { "confirmed": [ { "default": true, "kind": "mark", "mode": "light", "monochrome": true, "src": { "$asset": "string" }, "aspectRatio": 1, "vector": true } ], "candidates": [ { "src": { "$asset": "string" }, "aspectRatio": 1, "vector": true, "origin": "header", "score": 0 } ] }, "studio.assets": { "ogImage": { "$asset": "string" }, "favicon": { "$asset": "string" }, "screenshots": [ { "$asset": "string" } ], "landingPageScreenshots": { "desktop": { "$asset": "string" }, "mobile": { "$asset": "string" } }, "images": [ { "src": { "$asset": "string" }, "kind": "product", "alt": "string" } ], "patterns": [ { "$asset": "string" } ], "pressKitUrl": "http://example.com" }, "studio.colorRationale": { "light": "string", "dark": "string" }, "studio.provenance": { "property1": { "source": "extracted", "confidence": 0, "alternatives": [ null ], "evidenceIds": [ "string" ] }, "property2": { "source": "extracted", "confidence": 0, "alternatives": [ null ], "evidenceIds": [ "string" ] } } } }, "tokens": { "schemaVersion": "1", "name": "string", "domain": "string", "mode": "light", "modes": { "available": [ "light" ], "default": "light" }, "colors": { "roles": { "primary": "string", "secondary": "string", "accent": "string", "background": "string", "surface": "string", "text": "string", "textMuted": "string" }, "accent": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "neutral": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "semantic": { "bg": "string", "surface": "string", "border": "string", "text": "string", "textMuted": "string", "primary": "string", "primaryBright": "string", "onPrimary": "#000000", "snap": { "primary": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "primaryBright": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "onPrimary": { "picked": "#000000", "blackRatio": 0, "whiteRatio": 0 } }, "naive": { "primary": "string", "primaryBright": "string" }, "contrast": [ { "pair": "string", "ratio": 0, "required": 0, "pass": true } ] }, "modes": { "property1": { "roles": { "primary": "string", "secondary": "string", "accent": "string", "background": "string", "surface": "string", "text": "string", "textMuted": "string" }, "accent": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "neutral": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "semantic": { "bg": "string", "surface": "string", "border": "string", "text": "string", "textMuted": "string", "primary": "string", "primaryBright": "string", "onPrimary": "#000000", "snap": { "primary": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "primaryBright": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "onPrimary": { "picked": "#000000", "blackRatio": 0, "whiteRatio": 0 } }, "naive": { "primary": "string", "primaryBright": "string" }, "contrast": [ { "pair": "string", "ratio": 0, "required": 0, "pass": true } ] } }, "property2": { "roles": { "primary": "string", "secondary": "string", "accent": "string", "background": "string", "surface": "string", "text": "string", "textMuted": "string" }, "accent": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "neutral": { "property1": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" }, "property2": { "step": 0, "l": 0, "c": 0, "h": 0, "hex": "string", "css": "string" } }, "semantic": { "bg": "string", "surface": "string", "border": "string", "text": "string", "textMuted": "string", "primary": "string", "primaryBright": "string", "onPrimary": "#000000", "snap": { "primary": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "primaryBright": { "from": 0, "to": 0, "required": 0, "ratio": 0 }, "onPrimary": { "picked": "#000000", "blackRatio": 0, "whiteRatio": 0 } }, "naive": { "primary": "string", "primaryBright": "string" }, "contrast": [ { "pair": "string", "ratio": 0, "required": 0, "pass": true } ] } } } }, "fonts": { "display": { "family": "string", "sourceUrl": "string", "storageUrl": "string", "weights": [ "string" ], "fallbacks": [ "string" ], "files": [ { "storageUrl": "string", "variable": true, "weight": "string", "weightRange": [ "string", "string" ], "style": "normal", "format": "woff2" } ] }, "heading": { "family": "string", "sourceUrl": "string", "storageUrl": "string", "weights": [ "string" ], "fallbacks": [ "string" ], "files": [ { "storageUrl": "string", "variable": true, "weight": "string", "weightRange": [ "string", "string" ], "style": "normal", "format": "woff2" } ] }, "body": { "family": "string", "sourceUrl": "string", "storageUrl": "string", "weights": [ "string" ], "fallbacks": [ "string" ], "files": [ { "storageUrl": "string", "variable": true, "weight": "string", "weightRange": [ "string", "string" ], "style": "normal", "format": "woff2" } ] }, "mono": { "family": "string", "sourceUrl": "string", "storageUrl": "string", "weights": [ "string" ], "fallbacks": [ "string" ], "files": [ { "storageUrl": "string", "variable": true, "weight": "string", "weightRange": [ "string", "string" ], "style": "normal", "format": "woff2" } ] } }, "logo": { "src": "string", "darkSrc": "string", "aspectRatio": 1, "vector": true, "kind": "image" }, "radii": { "sm": 0, "md": 0, "lg": 0, "xl": 0 }, "spacing": { "xs": 0, "sm": 0, "md": 0, "lg": 0, "xl": 0, "density": "compact" }, "typography": { "display": { "family": "display", "size": 1, "lineHeight": 1, "letterSpacing": -1.7976931348623157e+308, "weight": 1, "transform": "none" }, "h1": { "family": "display", "size": 1, "lineHeight": 1, "letterSpacing": -1.7976931348623157e+308, "weight": 1, "transform": "none" }, "h2": { "family": "display", "size": 1, "lineHeight": 1, "letterSpacing": -1.7976931348623157e+308, "weight": 1, "transform": "none" }, "body": { "family": "display", "size": 1, "lineHeight": 1, "letterSpacing": -1.7976931348623157e+308, "weight": 1, "transform": "none" }, "caption": { "family": "display", "size": 1, "lineHeight": 1, "letterSpacing": -1.7976931348623157e+308, "weight": 1, "transform": "none" } }, "borders": { "width": { "subtle": 0, "default": 0, "strong": 0 }, "style": { "subtle": "none", "default": "none", "strong": "none" } }, "elevation": { "sm": "string", "md": "string", "lg": "string" }, "gradients": { "property1": "string", "property2": "string" }, "metadata": { "flags": [ "string" ], "anchor": 0, "primaryOklch": { "l": 0, "c": 0, "h": 0 } } }, "provenance": { "property1": { "source": "extracted", "confidence": 0, "alternatives": [ null ], "evidenceIds": [ "string" ] }, "property2": { "source": "extracted", "confidence": 0, "alternatives": [ null ], "evidenceIds": [ "string" ] } }, "meta": { "property1": null, "property2": null }, "schemaVersion": "string", "currentVersion": 0, "currentVersionId": "4a01a492-f21b-4cad-9836-910ec06f6e26", "extractionId": "4a01a492-f21b-4cad-9836-910ec06f6e26", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}{ "error": { "code": "string", "message": "string", "details": null }}