---
title: "POST update-file"
method: POST
path: "update-file"
---

# POST update-file

`POST update-file`

## Request

- Base URL: `https://design.penpot.app/api/main/methods`
- URL: `https://design.penpot.app/api/main/methods/update-file`
- Auth: none declared

## Request body

- object
  - `id` string, uuid, required: UUID formatted string
  - `sessionId` string, uuid, required: UUID formatted string
  - `revn` integer, required: integer
  - `vern` integer, required: integer
  - `features` string[]: Set of Strings
  - `changes` union[]
    - union
      - object
        - `commentThreadId` string, uuid, required: UUID formatted string
        - `pageId` string, uuid, required: UUID formatted string
        - `frameId` string, uuid, required: UUID formatted string
        - `position` string, point, required: Point
      - object
        - `type` 'add-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `obj` union, required
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[], required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `layout` 'grid' | 'flex'
            - `layoutFlexDir` 'column' | 'row-reverse' | 'column-reverse' | 'row'
            - `layoutGap` object
              - …
            - `layoutGapType` 'simple' | 'multiple'
            - `layoutWrapType` 'wrap' | 'nowrap'
            - `layoutPaddingType` 'simple' | 'multiple'
            - `layoutPadding` object
              - …
            - `layoutJustifyContent` 'space-around' | 'space-evenly' | 'start' | 'center' | 'space-between' | 'end' | 'stretch'
            - `layoutJustifyItems` 'start' | 'center' | 'end' | 'stretch'
            - `layoutAlignContent` 'space-around' | 'space-evenly' | 'start' | 'center' | 'space-between' | 'end' | 'stretch'
            - `layoutAlignItems` 'start' | 'center' | 'end' | 'stretch'
            - `layoutGridDir` 'column' | 'row'
            - `layoutGridRows` object[]
              - …
            - `layoutGridColumns` object[]
              - …
            - `layoutGridCells` object
            - `shapes` Uuid[], required
            - `hideFillOnExport` boolean
            - `showContent` boolean
            - `useForThumbnail` boolean
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
            - `variantId` string, uuid: UUID formatted string
            - `variantName` string
            - `variantError` string
            - `isVariantContainer` boolean
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[], required
            - `boolType` 'exclude' | 'intersection' | 'difference' | 'union', required
            - `content` string, required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `rx` number: number
            - `ry` number: number
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `rx` number: number
            - `ry` number: number
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `metadata` object, required
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[]
            - `content` union
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `content` string, required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `positionData` object[], nullable
              - …
            - `content` object, nullable
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `frameId` string, uuid, required: UUID formatted string
        - `parentId` string, uuid: UUID formatted string
        - `index` integer, nullable
        - `ignoreTouched` boolean
      - object
        - `type` 'mod-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `operations` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - object
        - `type` 'del-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
      - object
        - `type` 'set-guide', required
        - `pageId` string, uuid, required: UUID formatted string
        - `id` string, uuid, required: UUID formatted string
        - `params` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `axis` 'y' | 'x', required
          - `position` number, required: number
          - `frameId` string, uuid: UUID formatted string
          - `color` string, rgb, nullable: HEX Color String
      - object
        - `type` 'set-flow', required
        - `pageId` string, uuid, required: UUID formatted string
        - `id` string, uuid, required: UUID formatted string
        - `params` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `startingFrame` string, uuid, required: UUID formatted string
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'square', required
        - `params` object, nullable, required
          - `size` number: number
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'column', required
        - `params` object, nullable, required
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
          - `type` 'center' | 'right' | 'stretch' | 'left'
          - `size` number: number
          - `margin` number: number
          - `itemLength` number: number
          - `gutter` number: number
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'row', required
        - `params` object, nullable, required
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
          - `type` 'center' | 'right' | 'stretch' | 'left'
          - `size` number: number
          - `margin` number: number
          - `itemLength` number: number
          - `gutter` number: number
      - object
        - `type` 'fix-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `fix` string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
      - object
        - `type` 'mov-objects', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
        - `parentId` string, uuid, required: UUID formatted string
        - `shapes` unknown, required
        - `index` integer, nullable
        - `afterShape` unknown
        - `allowAlteringCopies` boolean
      - object
        - `type` 'reorder-children', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
        - `allowAlteringCopies` boolean
        - `parentId` string, uuid, required: UUID formatted string
        - `shapes` unknown, required
      - object
        - `type` 'add-page', required
        - `id` string, uuid: UUID formatted string
        - `name` string
        - `page` unknown
      - object
        - `type` 'mod-page', required
        - `id` string, uuid, required: UUID formatted string
        - `background` string, rgb, nullable: HEX Color String
        - `backgroundToken` string, nullable
        - `name` string
        - `pixelGridColor` string, rgb, nullable: HEX Color String
        - `pixelGridOpacity` number: number
      - object
        - `type` 'set-plugin-data', required
        - `objectType` 'color' | 'file' | 'page' | 'component' | 'shape' | 'typography', required
        - `objectId` string, uuid: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `namespace` string, required
        - `key` string, required
        - `value` string, nullable, required
      - object
        - `type` 'del-page', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'mov-page', required
        - `id` string, uuid, required: UUID formatted string
        - `index` integer, required
      - object
        - `type` 'reg-objects', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `shapes` Uuid[], required
      - object
        - `type` 'add-color', required
        - `color` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required: not whitespace string
          - `path` string
          - `opacity` number: number
          - `modifiedAt` string, iso
          - `pluginData` object
          - `color` string, rgb: HEX Color String
          - `gradient` object
            - `type` 'radial' | 'linear', required
            - `startX` number, required: number
            - `startY` number, required: number
            - `endX` number, required: number
            - `endY` number, required: number
            - `width` number, required: number
            - `stops` object[], required
              - …
          - `image` object
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required: not whitespace string
            - `id` string, uuid, required: UUID formatted string
            - `name` string: not whitespace string
            - `keepAspectRatio` boolean
            - `transform` object
              - …
      - object
        - `type` 'mod-color', required
        - `color` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required: not whitespace string
          - `path` string
          - `opacity` number: number
          - `modifiedAt` string, iso
          - `pluginData` object
          - `color` string, rgb: HEX Color String
          - `gradient` object
            - `type` 'radial' | 'linear', required
            - `startX` number, required: number
            - `startY` number, required: number
            - `endX` number, required: number
            - `endY` number, required: number
            - `width` number, required: number
            - `stops` object[], required
              - …
          - `image` object
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required: not whitespace string
            - `id` string, uuid, required: UUID formatted string
            - `name` string: not whitespace string
            - `keepAspectRatio` boolean
            - `transform` object
              - …
      - object
        - `type` 'del-color', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-media', required
        - `object` object, required
          - `id` string, uuid, required: UUID formatted string
          - `createdAt` string, iso
          - `deletedAt` string, iso
          - `name` string, required
          - `width` integer, required: integer
          - `height` integer, required: integer
          - `mtype` string, required
          - `mediaId` string, uuid, required: UUID formatted string
          - `fileId` string, uuid: UUID formatted string
          - `thumbnailId` string, uuid: UUID formatted string
          - `isLocal` boolean
      - object
        - `type` 'mod-media', required
        - `object` object, required
          - `id` string, uuid, required: UUID formatted string
          - `createdAt` string, iso
          - `deletedAt` string, iso
          - `name` string, required
          - `width` integer, required: integer
          - `height` integer, required: integer
          - `mtype` string, required
          - `mediaId` string, uuid, required: UUID formatted string
          - `fileId` string, uuid: UUID formatted string
          - `thumbnailId` string, uuid: UUID formatted string
          - `isLocal` boolean
      - object
        - `type` 'del-media', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-component', required
        - `id` string, uuid, required: UUID formatted string
        - `name` string, required
        - `path` string, required
        - `mainInstanceId` string, uuid, required: UUID formatted string
        - `mainInstancePage` string, uuid, required: UUID formatted string
        - `variantId` string, uuid: UUID formatted string
        - `variantProperties` object[]
          - `name` string, required
          - `value` string, required
      - object
        - `type` 'mod-component', required
        - `id` string, uuid, required: UUID formatted string
        - `name` string
        - `path` string
        - `variantId` string, uuid: UUID formatted string
        - `variantProperties` object[]
          - `name` string, required
          - `value` string, required
      - object
        - `type` 'del-component', required
        - `id` string, uuid, required: UUID formatted string
        - `delta` string, point: Point
        - `skipUndelete` boolean
      - object
        - `type` 'restore-component', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid, required: UUID formatted string
      - object
        - `type` 'purge-component', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-typography', required
        - `typography` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `fontId` string, required
          - `fontFamily` string, required
          - `fontVariantId` string, required
          - `fontSize` string, required
          - `fontWeight` string, required
          - `fontStyle` string, required
          - `lineHeight` string, required
          - `letterSpacing` string, required
          - `textTransform` string, required
          - `modifiedAt` string, iso
          - `path` string, nullable
          - `pluginData` object
      - object
        - `type` 'mod-typography', required
        - `typography` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `fontId` string, required
          - `fontFamily` string, required
          - `fontVariantId` string, required
          - `fontSize` string, required
          - `fontWeight` string, required
          - `fontStyle` string, required
          - `lineHeight` string, required
          - `letterSpacing` string, required
          - `textTransform` string, required
          - `modifiedAt` string, iso
          - `path` string, nullable
          - `pluginData` object
      - object
        - `type` 'del-typography', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'set-tokens-lib', required
        - `tokensLib` unknown, required
      - object
        - `type` 'set-token', required
        - `setId` string, uuid, required: UUID formatted string
        - `tokenId` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `type` 'sizing' | 'rotation' | 'color' | 'number' | 'font-size' | 'font-weight' | 'text-case' | 'other' | 'string' | 'dimensions' | 'stroke-width' | 'opacity' | 'typography' | 'text-decoration' | 'letter-spacing' | 'shadow' | 'border-radius' | 'boolean' | 'font-family' | 'spacing', required
          - `value` unknown, required
          - `description` string
          - `modifiedAt` string, iso
      - object
        - `type` 'set-token-set', required
        - `id` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `description` string
          - `modifiedAt` string, iso
          - `tokens` object
      - object
        - `type` 'set-token-theme', required
        - `id` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `group` string
          - `description` string
          - `isSource` boolean
          - `externalId` string
          - `modifiedAt` string, iso
          - `sets` string[]
      - object
        - `type` 'set-tokens-status', required
        - `themeIds` Uuid[], required
        - `setIds` Uuid[], required
      - object
        - `type` 'set-own-tokens-status', required
        - `themeIds` Uuid[], nullable, required
        - `setIds` Uuid[], nullable, required
      - object
        - `type` 'rename-token-set-group', required
        - `setGroupPath` string[], required
        - `setGroupFname` string, required
      - object
        - `type` 'move-token-set', required
        - `fromPath` string[], required
        - `toPath` string[], required
        - `beforePath` string[], nullable, required
        - `beforeGroup` boolean, nullable, required
      - object
        - `type` 'move-token-set-group', required
        - `fromPath` string[], required
        - `toPath` string[], required
        - `beforePath` string[], nullable, required
        - `beforeGroup` boolean, nullable, required
      - object
        - `type` 'set-base-font-size', required
        - `baseFontSize` string, required
      - object
        - `type` 'set-tokens-source', required
        - `fileId` string, uuid, required: UUID formatted string
        - `libraryId` string, uuid, required: UUID formatted string
  - `changesWithMetadata` object[]
    - `changes` union[], required
      - union
        - object
          - `commentThreadId` string, uuid, required: UUID formatted string
          - `pageId` string, uuid, required: UUID formatted string
          - `frameId` string, uuid, required: UUID formatted string
          - `position` string, point, required: Point
        - object
          - `type` 'add-obj', required
          - `id` string, uuid, required: UUID formatted string
          - `obj` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `frameId` string, uuid, required: UUID formatted string
          - `parentId` string, uuid: UUID formatted string
          - `index` integer, nullable
          - `ignoreTouched` boolean
        - object
          - `type` 'mod-obj', required
          - `id` string, uuid, required: UUID formatted string
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `operations` union[], required
            - union
              - …
        - object
          - `type` 'del-obj', required
          - `id` string, uuid, required: UUID formatted string
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `ignoreTouched` boolean
        - object
          - `type` 'set-guide', required
          - `pageId` string, uuid, required: UUID formatted string
          - `id` string, uuid, required: UUID formatted string
          - `params` object, nullable, required
            - `id` string, uuid, required: UUID formatted string
            - `axis` 'y' | 'x', required
            - `position` number, required: number
            - `frameId` string, uuid: UUID formatted string
            - `color` string, rgb, nullable: HEX Color String
        - object
          - `type` 'set-flow', required
          - `pageId` string, uuid, required: UUID formatted string
          - `id` string, uuid, required: UUID formatted string
          - `params` object, nullable, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `startingFrame` string, uuid, required: UUID formatted string
        - object
          - `type` 'set-default-grid', required
          - `pageId` string, uuid, required: UUID formatted string
          - `gridType` 'square', required
          - `params` object, nullable, required
            - `size` number: number
            - `color` object, required
              - …
        - object
          - `type` 'set-default-grid', required
          - `pageId` string, uuid, required: UUID formatted string
          - `gridType` 'column', required
          - `params` object, nullable, required
            - `color` object, required
              - …
            - `type` 'center' | 'right' | 'stretch' | 'left'
            - `size` number: number
            - `margin` number: number
            - `itemLength` number: number
            - `gutter` number: number
        - object
          - `type` 'set-default-grid', required
          - `pageId` string, uuid, required: UUID formatted string
          - `gridType` 'row', required
          - `params` object, nullable, required
            - `color` object, required
              - …
            - `type` 'center' | 'right' | 'stretch' | 'left'
            - `size` number: number
            - `margin` number: number
            - `itemLength` number: number
            - `gutter` number: number
        - object
          - `type` 'fix-obj', required
          - `id` string, uuid, required: UUID formatted string
          - `fix` string
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
        - object
          - `type` 'mov-objects', required
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `ignoreTouched` boolean
          - `parentId` string, uuid, required: UUID formatted string
          - `shapes` unknown, required
          - `index` integer, nullable
          - `afterShape` unknown
          - `allowAlteringCopies` boolean
        - object
          - `type` 'reorder-children', required
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `ignoreTouched` boolean
          - `allowAlteringCopies` boolean
          - `parentId` string, uuid, required: UUID formatted string
          - `shapes` unknown, required
        - object
          - `type` 'add-page', required
          - `id` string, uuid: UUID formatted string
          - `name` string
          - `page` unknown
        - object
          - `type` 'mod-page', required
          - `id` string, uuid, required: UUID formatted string
          - `background` string, rgb, nullable: HEX Color String
          - `backgroundToken` string, nullable
          - `name` string
          - `pixelGridColor` string, rgb, nullable: HEX Color String
          - `pixelGridOpacity` number: number
        - object
          - `type` 'set-plugin-data', required
          - `objectType` 'color' | 'file' | 'page' | 'component' | 'shape' | 'typography', required
          - `objectId` string, uuid: UUID formatted string
          - `pageId` string, uuid: UUID formatted string
          - `namespace` string, required
          - `key` string, required
          - `value` string, nullable, required
        - object
          - `type` 'del-page', required
          - `id` string, uuid, required: UUID formatted string
        - object
          - `type` 'mov-page', required
          - `id` string, uuid, required: UUID formatted string
          - `index` integer, required
        - object
          - `type` 'reg-objects', required
          - `pageId` string, uuid: UUID formatted string
          - `componentId` string, uuid: UUID formatted string
          - `shapes` Uuid[], required
        - object
          - `type` 'add-color', required
          - `color` object, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required: not whitespace string
            - `path` string
            - `opacity` number: number
            - `modifiedAt` string, iso
            - `pluginData` object
            - `color` string, rgb: HEX Color String
            - `gradient` object
              - …
            - `image` object
              - …
        - object
          - `type` 'mod-color', required
          - `color` object, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required: not whitespace string
            - `path` string
            - `opacity` number: number
            - `modifiedAt` string, iso
            - `pluginData` object
            - `color` string, rgb: HEX Color String
            - `gradient` object
              - …
            - `image` object
              - …
        - object
          - `type` 'del-color', required
          - `id` string, uuid, required: UUID formatted string
        - object
          - `type` 'add-media', required
          - `object` object, required
            - `id` string, uuid, required: UUID formatted string
            - `createdAt` string, iso
            - `deletedAt` string, iso
            - `name` string, required
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required
            - `mediaId` string, uuid, required: UUID formatted string
            - `fileId` string, uuid: UUID formatted string
            - `thumbnailId` string, uuid: UUID formatted string
            - `isLocal` boolean
        - object
          - `type` 'mod-media', required
          - `object` object, required
            - `id` string, uuid, required: UUID formatted string
            - `createdAt` string, iso
            - `deletedAt` string, iso
            - `name` string, required
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required
            - `mediaId` string, uuid, required: UUID formatted string
            - `fileId` string, uuid: UUID formatted string
            - `thumbnailId` string, uuid: UUID formatted string
            - `isLocal` boolean
        - object
          - `type` 'del-media', required
          - `id` string, uuid, required: UUID formatted string
        - object
          - `type` 'add-component', required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `path` string, required
          - `mainInstanceId` string, uuid, required: UUID formatted string
          - `mainInstancePage` string, uuid, required: UUID formatted string
          - `variantId` string, uuid: UUID formatted string
          - `variantProperties` object[]
            - `name` string, required
            - `value` string, required
        - object
          - `type` 'mod-component', required
          - `id` string, uuid, required: UUID formatted string
          - `name` string
          - `path` string
          - `variantId` string, uuid: UUID formatted string
          - `variantProperties` object[]
            - `name` string, required
            - `value` string, required
        - object
          - `type` 'del-component', required
          - `id` string, uuid, required: UUID formatted string
          - `delta` string, point: Point
          - `skipUndelete` boolean
        - object
          - `type` 'restore-component', required
          - `id` string, uuid, required: UUID formatted string
          - `pageId` string, uuid, required: UUID formatted string
        - object
          - `type` 'purge-component', required
          - `id` string, uuid, required: UUID formatted string
        - object
          - `type` 'add-typography', required
          - `typography` object, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `fontId` string, required
            - `fontFamily` string, required
            - `fontVariantId` string, required
            - `fontSize` string, required
            - `fontWeight` string, required
            - `fontStyle` string, required
            - `lineHeight` string, required
            - `letterSpacing` string, required
            - `textTransform` string, required
            - `modifiedAt` string, iso
            - `path` string, nullable
            - `pluginData` object
        - object
          - `type` 'mod-typography', required
          - `typography` object, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `fontId` string, required
            - `fontFamily` string, required
            - `fontVariantId` string, required
            - `fontSize` string, required
            - `fontWeight` string, required
            - `fontStyle` string, required
            - `lineHeight` string, required
            - `letterSpacing` string, required
            - `textTransform` string, required
            - `modifiedAt` string, iso
            - `path` string, nullable
            - `pluginData` object
        - object
          - `type` 'del-typography', required
          - `id` string, uuid, required: UUID formatted string
        - object
          - `type` 'set-tokens-lib', required
          - `tokensLib` unknown, required
        - object
          - `type` 'set-token', required
          - `setId` string, uuid, required: UUID formatted string
          - `tokenId` string, uuid, required: UUID formatted string
          - `attrs` object, nullable, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'sizing' | 'rotation' | 'color' | 'number' | 'font-size' | 'font-weight' | 'text-case' | 'other' | 'string' | 'dimensions' | 'stroke-width' | 'opacity' | 'typography' | 'text-decoration' | 'letter-spacing' | 'shadow' | 'border-radius' | 'boolean' | 'font-family' | 'spacing', required
            - `value` unknown, required
            - `description` string
            - `modifiedAt` string, iso
        - object
          - `type` 'set-token-set', required
          - `id` string, uuid, required: UUID formatted string
          - `attrs` object, nullable, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `description` string
            - `modifiedAt` string, iso
            - `tokens` object
        - object
          - `type` 'set-token-theme', required
          - `id` string, uuid, required: UUID formatted string
          - `attrs` object, nullable, required
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `group` string
            - `description` string
            - `isSource` boolean
            - `externalId` string
            - `modifiedAt` string, iso
            - `sets` string[]
        - object
          - `type` 'set-tokens-status', required
          - `themeIds` Uuid[], required
          - `setIds` Uuid[], required
        - object
          - `type` 'set-own-tokens-status', required
          - `themeIds` Uuid[], nullable, required
          - `setIds` Uuid[], nullable, required
        - object
          - `type` 'rename-token-set-group', required
          - `setGroupPath` string[], required
          - `setGroupFname` string, required
        - object
          - `type` 'move-token-set', required
          - `fromPath` string[], required
          - `toPath` string[], required
          - `beforePath` string[], nullable, required
          - `beforeGroup` boolean, nullable, required
        - object
          - `type` 'move-token-set-group', required
          - `fromPath` string[], required
          - `toPath` string[], required
          - `beforePath` string[], nullable, required
          - `beforeGroup` boolean, nullable, required
        - object
          - `type` 'set-base-font-size', required
          - `baseFontSize` string, required
        - object
          - `type` 'set-tokens-source', required
          - `fileId` string, uuid, required: UUID formatted string
          - `libraryId` string, uuid, required: UUID formatted string
    - `hintOrigin` string
    - `hintEvents` string[]
  - `skipValidate` boolean: boolean

## Response `default`

A default response

- object[]
  - `changes` union[], required
    - union
      - object
        - `commentThreadId` string, uuid, required: UUID formatted string
        - `pageId` string, uuid, required: UUID formatted string
        - `frameId` string, uuid, required: UUID formatted string
        - `position` string, point, required: Point
      - object
        - `type` 'add-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `obj` union, required
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[], required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `layout` 'grid' | 'flex'
            - `layoutFlexDir` 'column' | 'row-reverse' | 'column-reverse' | 'row'
            - `layoutGap` object
              - …
            - `layoutGapType` 'simple' | 'multiple'
            - `layoutWrapType` 'wrap' | 'nowrap'
            - `layoutPaddingType` 'simple' | 'multiple'
            - `layoutPadding` object
              - …
            - `layoutJustifyContent` 'space-around' | 'space-evenly' | 'start' | 'center' | 'space-between' | 'end' | 'stretch'
            - `layoutJustifyItems` 'start' | 'center' | 'end' | 'stretch'
            - `layoutAlignContent` 'space-around' | 'space-evenly' | 'start' | 'center' | 'space-between' | 'end' | 'stretch'
            - `layoutAlignItems` 'start' | 'center' | 'end' | 'stretch'
            - `layoutGridDir` 'column' | 'row'
            - `layoutGridRows` object[]
              - …
            - `layoutGridColumns` object[]
              - …
            - `layoutGridCells` object
            - `shapes` Uuid[], required
            - `hideFillOnExport` boolean
            - `showContent` boolean
            - `useForThumbnail` boolean
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
            - `variantId` string, uuid: UUID formatted string
            - `variantName` string
            - `variantError` string
            - `isVariantContainer` boolean
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[], required
            - `boolType` 'exclude' | 'intersection' | 'difference' | 'union', required
            - `content` string, required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `rx` number: number
            - `ry` number: number
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `rx` number: number
            - `ry` number: number
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `metadata` object, required
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `shapes` Uuid[]
            - `content` union
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `content` string, required
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
          - object
            - `layoutItemMarginType` 'simple' | 'multiple'
            - `layoutItemMargin` object
              - …
            - `layoutItemMaxH` number: number
            - `layoutItemMinH` number: number
            - `layoutItemMaxW` number: number
            - `layoutItemMinW` number: number
            - `layoutItemHSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemVSizing` 'fill' | 'fix' | 'auto'
            - `layoutItemAlignSelf` 'start' | 'center' | 'end' | 'stretch'
            - `layoutItemAbsolute` boolean
            - `layoutItemZIndex` number: number
            - `positionData` object[], nullable
              - …
            - `content` object, nullable
              - …
            - `pageId` string, uuid: UUID formatted string
            - `componentId` string, uuid: UUID formatted string
            - `componentFile` string, uuid: UUID formatted string
            - `componentRoot` boolean
            - `mainInstance` boolean
            - `remoteSynced` boolean
            - `shapeRef` string, uuid: UUID formatted string
            - `touched` string[], nullable
            - `blocked` boolean
            - `collapsed` boolean
            - `locked` boolean
            - `hidden` boolean
            - `maskedGroup` boolean
            - `fills` union
              - …
            - `proportion` number: number
            - `proportionLock` boolean
            - `constraintsH` 'scale' | 'center' | 'right' | 'leftright' | 'left'
            - `constraintsV` 'bottom' | 'scale' | 'top' | 'center' | 'topbottom'
            - `fixedScroll` boolean
            - `r1` number: number
            - `r2` number: number
            - `r3` number: number
            - `r4` number: number
            - `opacity` number: number
            - `grids` union[]
              - …
            - `exports` object[]
              - …
            - `strokes` object[]
              - …
            - `blendMode` 'hue' | 'screen' | 'color' | 'darken' | 'saturation' | 'lighten' | 'normal' | 'overlay' | 'difference' | 'luminosity' | 'exclusion' | 'hard-light' | 'multiply' | 'soft-light' | 'color-dodge' | 'color-burn'
            - `interactions` union[]
              - …
            - `shadow` object[]
              - …
            - `blur` object
              - …
            - `backgroundBlur` object
              - …
            - `growType` 'auto-height' | 'fixed' | 'auto-width'
            - `appliedTokens` object
              - …
            - `pluginData` object
            - `rotation` number: number
            - `flipX` boolean, nullable
            - `flipY` boolean, nullable
            - `hideInViewer` boolean
            - `svgAttrs` object
            - `svgDefs` object
            - `svgTransform` object
            - `svgViewbox` object
            - `x` number, required: number
            - `y` number, required: number
            - `width` number, required: number
            - `height` number, required: number
            - `id` string, uuid, required: UUID formatted string
            - `name` string, required
            - `type` 'path' | 'group' | 'frame' | 'circle' | 'svg-raw' | 'image' | 'bool' | 'rect' | 'text', required
            - `selrect` GeomRect, required
              - …
            - `points` GeomPoint[], required
            - `transform` string, matrix, required: Matrix instance
            - `transformInverse` string, matrix, required: Matrix instance
            - `parentId` string, uuid, required: UUID formatted string
            - `frameId` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `frameId` string, uuid, required: UUID formatted string
        - `parentId` string, uuid: UUID formatted string
        - `index` integer, nullable
        - `ignoreTouched` boolean
      - object
        - `type` 'mod-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `operations` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - object
        - `type` 'del-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
      - object
        - `type` 'set-guide', required
        - `pageId` string, uuid, required: UUID formatted string
        - `id` string, uuid, required: UUID formatted string
        - `params` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `axis` 'y' | 'x', required
          - `position` number, required: number
          - `frameId` string, uuid: UUID formatted string
          - `color` string, rgb, nullable: HEX Color String
      - object
        - `type` 'set-flow', required
        - `pageId` string, uuid, required: UUID formatted string
        - `id` string, uuid, required: UUID formatted string
        - `params` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `startingFrame` string, uuid, required: UUID formatted string
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'square', required
        - `params` object, nullable, required
          - `size` number: number
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'column', required
        - `params` object, nullable, required
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
          - `type` 'center' | 'right' | 'stretch' | 'left'
          - `size` number: number
          - `margin` number: number
          - `itemLength` number: number
          - `gutter` number: number
      - object
        - `type` 'set-default-grid', required
        - `pageId` string, uuid, required: UUID formatted string
        - `gridType` 'row', required
        - `params` object, nullable, required
          - `color` object, required
            - `color` string, rgb, required: HEX Color String
            - `opacity` number, required: number
          - `type` 'center' | 'right' | 'stretch' | 'left'
          - `size` number: number
          - `margin` number: number
          - `itemLength` number: number
          - `gutter` number: number
      - object
        - `type` 'fix-obj', required
        - `id` string, uuid, required: UUID formatted string
        - `fix` string
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
      - object
        - `type` 'mov-objects', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
        - `parentId` string, uuid, required: UUID formatted string
        - `shapes` unknown, required
        - `index` integer, nullable
        - `afterShape` unknown
        - `allowAlteringCopies` boolean
      - object
        - `type` 'reorder-children', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `ignoreTouched` boolean
        - `allowAlteringCopies` boolean
        - `parentId` string, uuid, required: UUID formatted string
        - `shapes` unknown, required
      - object
        - `type` 'add-page', required
        - `id` string, uuid: UUID formatted string
        - `name` string
        - `page` unknown
      - object
        - `type` 'mod-page', required
        - `id` string, uuid, required: UUID formatted string
        - `background` string, rgb, nullable: HEX Color String
        - `backgroundToken` string, nullable
        - `name` string
        - `pixelGridColor` string, rgb, nullable: HEX Color String
        - `pixelGridOpacity` number: number
      - object
        - `type` 'set-plugin-data', required
        - `objectType` 'color' | 'file' | 'page' | 'component' | 'shape' | 'typography', required
        - `objectId` string, uuid: UUID formatted string
        - `pageId` string, uuid: UUID formatted string
        - `namespace` string, required
        - `key` string, required
        - `value` string, nullable, required
      - object
        - `type` 'del-page', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'mov-page', required
        - `id` string, uuid, required: UUID formatted string
        - `index` integer, required
      - object
        - `type` 'reg-objects', required
        - `pageId` string, uuid: UUID formatted string
        - `componentId` string, uuid: UUID formatted string
        - `shapes` Uuid[], required
      - object
        - `type` 'add-color', required
        - `color` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required: not whitespace string
          - `path` string
          - `opacity` number: number
          - `modifiedAt` string, iso
          - `pluginData` object
          - `color` string, rgb: HEX Color String
          - `gradient` object
            - `type` 'radial' | 'linear', required
            - `startX` number, required: number
            - `startY` number, required: number
            - `endX` number, required: number
            - `endY` number, required: number
            - `width` number, required: number
            - `stops` object[], required
              - …
          - `image` object
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required: not whitespace string
            - `id` string, uuid, required: UUID formatted string
            - `name` string: not whitespace string
            - `keepAspectRatio` boolean
            - `transform` object
              - …
      - object
        - `type` 'mod-color', required
        - `color` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required: not whitespace string
          - `path` string
          - `opacity` number: number
          - `modifiedAt` string, iso
          - `pluginData` object
          - `color` string, rgb: HEX Color String
          - `gradient` object
            - `type` 'radial' | 'linear', required
            - `startX` number, required: number
            - `startY` number, required: number
            - `endX` number, required: number
            - `endY` number, required: number
            - `width` number, required: number
            - `stops` object[], required
              - …
          - `image` object
            - `width` integer, required: integer
            - `height` integer, required: integer
            - `mtype` string, required: not whitespace string
            - `id` string, uuid, required: UUID formatted string
            - `name` string: not whitespace string
            - `keepAspectRatio` boolean
            - `transform` object
              - …
      - object
        - `type` 'del-color', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-media', required
        - `object` object, required
          - `id` string, uuid, required: UUID formatted string
          - `createdAt` string, iso
          - `deletedAt` string, iso
          - `name` string, required
          - `width` integer, required: integer
          - `height` integer, required: integer
          - `mtype` string, required
          - `mediaId` string, uuid, required: UUID formatted string
          - `fileId` string, uuid: UUID formatted string
          - `thumbnailId` string, uuid: UUID formatted string
          - `isLocal` boolean
      - object
        - `type` 'mod-media', required
        - `object` object, required
          - `id` string, uuid, required: UUID formatted string
          - `createdAt` string, iso
          - `deletedAt` string, iso
          - `name` string, required
          - `width` integer, required: integer
          - `height` integer, required: integer
          - `mtype` string, required
          - `mediaId` string, uuid, required: UUID formatted string
          - `fileId` string, uuid: UUID formatted string
          - `thumbnailId` string, uuid: UUID formatted string
          - `isLocal` boolean
      - object
        - `type` 'del-media', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-component', required
        - `id` string, uuid, required: UUID formatted string
        - `name` string, required
        - `path` string, required
        - `mainInstanceId` string, uuid, required: UUID formatted string
        - `mainInstancePage` string, uuid, required: UUID formatted string
        - `variantId` string, uuid: UUID formatted string
        - `variantProperties` object[]
          - `name` string, required
          - `value` string, required
      - object
        - `type` 'mod-component', required
        - `id` string, uuid, required: UUID formatted string
        - `name` string
        - `path` string
        - `variantId` string, uuid: UUID formatted string
        - `variantProperties` object[]
          - `name` string, required
          - `value` string, required
      - object
        - `type` 'del-component', required
        - `id` string, uuid, required: UUID formatted string
        - `delta` string, point: Point
        - `skipUndelete` boolean
      - object
        - `type` 'restore-component', required
        - `id` string, uuid, required: UUID formatted string
        - `pageId` string, uuid, required: UUID formatted string
      - object
        - `type` 'purge-component', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'add-typography', required
        - `typography` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `fontId` string, required
          - `fontFamily` string, required
          - `fontVariantId` string, required
          - `fontSize` string, required
          - `fontWeight` string, required
          - `fontStyle` string, required
          - `lineHeight` string, required
          - `letterSpacing` string, required
          - `textTransform` string, required
          - `modifiedAt` string, iso
          - `path` string, nullable
          - `pluginData` object
      - object
        - `type` 'mod-typography', required
        - `typography` object, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `fontId` string, required
          - `fontFamily` string, required
          - `fontVariantId` string, required
          - `fontSize` string, required
          - `fontWeight` string, required
          - `fontStyle` string, required
          - `lineHeight` string, required
          - `letterSpacing` string, required
          - `textTransform` string, required
          - `modifiedAt` string, iso
          - `path` string, nullable
          - `pluginData` object
      - object
        - `type` 'del-typography', required
        - `id` string, uuid, required: UUID formatted string
      - object
        - `type` 'set-tokens-lib', required
        - `tokensLib` unknown, required
      - object
        - `type` 'set-token', required
        - `setId` string, uuid, required: UUID formatted string
        - `tokenId` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `type` 'sizing' | 'rotation' | 'color' | 'number' | 'font-size' | 'font-weight' | 'text-case' | 'other' | 'string' | 'dimensions' | 'stroke-width' | 'opacity' | 'typography' | 'text-decoration' | 'letter-spacing' | 'shadow' | 'border-radius' | 'boolean' | 'font-family' | 'spacing', required
          - `value` unknown, required
          - `description` string
          - `modifiedAt` string, iso
      - object
        - `type` 'set-token-set', required
        - `id` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `description` string
          - `modifiedAt` string, iso
          - `tokens` object
      - object
        - `type` 'set-token-theme', required
        - `id` string, uuid, required: UUID formatted string
        - `attrs` object, nullable, required
          - `id` string, uuid, required: UUID formatted string
          - `name` string, required
          - `group` string
          - `description` string
          - `isSource` boolean
          - `externalId` string
          - `modifiedAt` string, iso
          - `sets` string[]
      - object
        - `type` 'set-tokens-status', required
        - `themeIds` Uuid[], required
        - `setIds` Uuid[], required
      - object
        - `type` 'set-own-tokens-status', required
        - `themeIds` Uuid[], nullable, required
        - `setIds` Uuid[], nullable, required
      - object
        - `type` 'rename-token-set-group', required
        - `setGroupPath` string[], required
        - `setGroupFname` string, required
      - object
        - `type` 'move-token-set', required
        - `fromPath` string[], required
        - `toPath` string[], required
        - `beforePath` string[], nullable, required
        - `beforeGroup` boolean, nullable, required
      - object
        - `type` 'move-token-set-group', required
        - `fromPath` string[], required
        - `toPath` string[], required
        - `beforePath` string[], nullable, required
        - `beforeGroup` boolean, nullable, required
      - object
        - `type` 'set-base-font-size', required
        - `baseFontSize` string, required
      - object
        - `type` 'set-tokens-source', required
        - `fileId` string, uuid, required: UUID formatted string
        - `libraryId` string, uuid, required: UUID formatted string
  - `fileId` string, uuid, required: UUID formatted string
  - `id` string, uuid, required: UUID formatted string
  - `revn` integer, required: integer
  - `sessionId` string, uuid, required: UUID formatted string

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-09-10** `d014f72adc3f`: 3 breaking, 66 info
  - removed `subschema #2: ShapeMinimalRecord, subschema #3: ShapeMinimalRecord, subschema #4: ShapeMinimalRecord, subschema #5: ShapeMinimalRecord, subschema #6: ShapeMinimalRecord, subschema #7: ShapeMinimalRecord, subschema #8: ShapeMinimalRecord, subschema #9: ShapeMinimalRecord` from the `changes/items/oneOf[subschema #2: AddObjChange]/obj/allOf[subschema #1: Shape]/` request property `oneOf` list
  - removed `subschema #2: ShapeMinimalRecord, subschema #3: ShapeMinimalRecord, subschema #4: ShapeMinimalRecord, subschema #5: ShapeMinimalRecord, subschema #6: ShapeMinimalRecord, subschema #7: ShapeMinimalRecord, subschema #8: ShapeMinimalRecord, subschema #9: ShapeMinimalRecord` from the `changesWithMetadata/items/changes/items/oneOf[subschema #2: AddObjChange]/obj/allOf[subschema #1: Shape]/` request property `oneOf` list
  - added `subschema #2: ShapeMinimalRecord, subschema #3: ShapeMinimalRecord, subschema #4: ShapeMinimalRecord, subschema #5: ShapeMinimalRecord, subschema #6: ShapeMinimalRecord, subschema #7: ShapeMinimalRecord, subschema #8: ShapeMinimalRecord, subschema #9: ShapeMinimalRecord` to the `items/changes/items/oneOf[subschema #2: AddObjChange]/obj/allOf[subschema #1: Shape]/` response property `oneOf` list for the response status `default`
  - added the new optional request property `changes/items/oneOf[subschema #10: ReorderChildrenChange]/allowAlteringCopies`
  - …65 more

[Operation history](https://skmtc.dev/penpot/apis/penpot-api/changes/update-file/post.md)

---

[API](https://skmtc.dev/penpot/apis/penpot-api.md) - [All operations](https://skmtc.dev/penpot/apis/penpot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/penpot/apis/penpot-api/revisions/a195708d87bc?raw)
