{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/miro/json-schema/miro-image-item-schema.json",
  "title": "ImageItem",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/miro-image-items-api-openapi.yml#/components/schemas/ImageItem",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier (ID) of an item."
    },
    "data": {
      "$ref": "#/$defs/ImageData"
    },
    "position": {
      "$ref": "#/$defs/Position"
    },
    "geometry": {
      "$ref": "#/$defs/Geometry"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time when the item was created. <br>Format: UTC, adheres to [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601), includes a [trailing Z offset](https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC))."
    },
    "createdBy": {
      "$ref": "#/$defs/createdBy"
    },
    "modifiedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time when the item was last modified. <br>Format: UTC, adheres to [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601), includes a [trailing Z offset](https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC))."
    },
    "modifiedBy": {
      "$ref": "#/$defs/modifiedBy"
    },
    "parent": {
      "$ref": "#/$defs/ParentLinksEnvelope"
    },
    "links": {
      "$ref": "#/$defs/WidgetLinks"
    },
    "type": {
      "type": "string",
      "description": "Type of item that is returned."
    }
  },
  "required": [
    "id",
    "type"
  ],
  "$defs": {
    "Geometry": {
      "type": "object",
      "description": "Contains geometrical information about the item, such as its width or height.",
      "properties": {
        "height": {
          "type": "number",
          "format": "double",
          "description": "Height of the item, in pixels."
        },
        "rotation": {
          "type": "number",
          "format": "double",
          "description": "Rotation angle of an item, in degrees, relative to the board. You can rotate items clockwise (right) and counterclockwise (left) by specifying positive and negative values, respectively."
        },
        "width": {
          "type": "number",
          "format": "double",
          "description": "Width of the item, in pixels."
        }
      }
    },
    "ImageData": {
      "type": "object",
      "properties": {
        "imageUrl": {
          "type": "string",
          "description": "The URL to download the resource. You must use your access token to access the URL.\nThe URL contains the `redirect` parameter and the `format` parameter to control the request execution as described in the following parameters:\n`format` parameter: By default, the image format is set to the preview image. If you want to download the original image, set the `format` parameter in the URL to `original`.\n`redirect`: By default, the `redirect` parameter is set to `false` and the resource object containing the URL and the resource type is returned with a 200 OK HTTP code. This URL is valid for 60 seconds. You can use this URL to retrieve the resource file.\nIf the `redirect` parameter is set to `true`, a 307 TEMPORARY_REDIRECT HTTP response is returned. If you follow HTTP 3xx responses as redirects, you will automatically be redirected to the resource file and the content type returned can be `image/png`, 'image/svg', or 'image/jpg', depending on the original image type."
        },
        "title": {
          "type": "string",
          "description": "A short text header to identify the image."
        }
      }
    },
    "ParentLinksEnvelope": {
      "type": "object",
      "description": "Contains information about the parent frame for the item.",
      "properties": {
        "id": {
          "type": "string",
          "format": "int64",
          "description": "Unique identifier (ID) of the parent frame for the item."
        },
        "links": {
          "$ref": "#/$defs/SelfLink"
        }
      }
    },
    "Position": {
      "type": "object",
      "description": "Contains location information about the item, such as its x coordinate, y coordinate, and the origin of the x and y coordinates.",
      "properties": {
        "origin": {
          "type": "string",
          "default": "center",
          "description": "Area of the item that is referenced by its x and y coordinates. For example, an item with a center origin will have its x and y coordinates point to its center. The center point of the board has x: 0 and y: 0 coordinates.\nCurrently, only one option is supported.",
          "enum": [
            "center"
          ]
        },
        "relativeTo": {
          "type": "string",
          "enum": [
            "canvas_center",
            "parent_top_left"
          ]
        },
        "x": {
          "type": "number",
          "format": "double",
          "description": "X-axis coordinate of the location of the item on the board.\nBy default, all items have absolute positioning to the board, not the current viewport. Default: 0.\nThe center point of the board has `x: 0` and `y: 0` coordinates."
        },
        "y": {
          "type": "number",
          "format": "double",
          "description": "Y-axis coordinate of the location of the item on the board.\nBy default, all items have absolute positioning to the board, not the current viewport. Default: 0.\nThe center point of the board has `x: 0` and `y: 0` coordinates."
        }
      }
    },
    "SelfLink": {
      "type": "object",
      "description": "Contains applicable links for the current object.",
      "properties": {
        "self": {
          "type": "string",
          "description": "Link to obtain more information about the current object."
        }
      }
    },
    "WidgetLinks": {
      "type": "object",
      "description": "Contains applicable links for the item.",
      "properties": {
        "related": {
          "type": "string",
          "description": "Link to obtain information about the child items related to the frame."
        },
        "self": {
          "type": "string",
          "description": "Link to obtain information about the current item."
        }
      }
    },
    "createdBy": {
      "type": "object",
      "description": "Contains information about the user who created the item.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier (ID) of the user."
        },
        "type": {
          "type": "string",
          "description": "Indicates the type of object returned. In this case, `type` returns `user`."
        }
      }
    },
    "modifiedBy": {
      "type": "object",
      "description": "Contains information about the user who last modified the item.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier (ID) of the user."
        },
        "type": {
          "type": "string",
          "description": "Indicates the type of object returned. In this case, `type` returns `user`."
        }
      }
    }
  }
}