openapi: 3.0.1 info: title: Miro Developer Platform AI Interaction Logs Flowchart shapes (experimental) API version: v2.0 description: ' ### Miro Developer Platform concepts - New to the Miro Developer Platform? Interested in learning more about platform concepts?? [Read our introduction page](https://beta.developers.miro.com/docs/introduction) and familiarize yourself with the Miro Developer Platform capabilities in a few minutes. ### Getting started with the Miro REST API - [Quickstart (video):](https://beta.developers.miro.com/docs/try-out-the-rest-api-in-less-than-3-minutes) try the REST API in less than 3 minutes. - [Quickstart (article):](https://beta.developers.miro.com/docs/build-your-first-hello-world-app-1) get started and try the REST API in less than 3 minutes. ### Miro REST API tutorials Check out our how-to articles with step-by-step instructions and code examples so you can: - [Get started with OAuth 2.0 and Miro](https://beta.developers.miro.com/docs/getting-started-with-oauth) ### Miro App Examples Clone our [Miro App Examples repository](https://github.com/miroapp/app-examples) to get inspiration, customize, and explore apps built on top of Miro''s Developer Platform 2.0. ' servers: - url: https://api.miro.com/ tags: - name: Flowchart shapes (experimental) paths: /v2-experimental/boards/{board_id}/items: get: description: 'Retrieves a list of items for a specific board. You can retrieve all items on the board, a list of child items inside a parent item, or a list of specific types of items by specifying URL query parameter values. This method returns results using a cursor-based approach. A cursor-paginated method returns a portion of the total set of results based on the limit specified and a cursor that points to the next portion of the results. To retrieve the next portion of the collection, on your next call to the same method, set the `cursor` parameter equal to the `cursor` value you received in the response of the previous request. For example, if you set the `limit` query parameter to `10` and the board contains 20 objects, the first call will return information about the first 10 objects in the response along with a cursor parameter and value. In this example, let''s say the cursor parameter value returned in the response is `foo`. If you want to retrieve the next set of objects, on your next call to the same method, set the cursor parameter value to `foo`.

Required scope

boards:read

Rate limiting

Level 2
' operationId: get-items-experimental parameters: - in: query name: limit schema: type: string default: '10' description: The maximum number of results to return per call. If the number of items in the response is greater than the limit specified, the response returns the cursor parameter with a value. maximum: 50 minimum: 10 - in: query name: type schema: type: string enum: - shape - in: query name: cursor schema: type: string description: A cursor-paginated method returns a portion of the total set of results based on the limit specified and a `cursor` that points to the next portion of the results. To retrieve the next portion of the collection, set the `cursor` parameter equal to the `cursor` value you received in the response of the previous request. - description: Unique identifier (ID) of the board for which you want to retrieve the list of available items. in: path name: board_id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GenericItemCursorPaged' description: Items retrieved '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Get items on board tags: - Flowchart shapes (experimental) /v2-experimental/boards/{board_id}/items/{item_id}: get: description: Retrieves information for a specific item on a board.

Required scope

boards:read

Rate limiting

Level 1
operationId: get-specific-item-experimental parameters: - description: Unique identifier (ID) of the board from which you want to retrieve a specific item. in: path name: board_id required: true schema: type: string - description: Unique identifier (ID) of the item that you want to retrieve. in: path name: item_id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GenericItem' description: Item retrieved '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Get specific item on board tags: - Flowchart shapes (experimental) /v2-experimental/boards/{board_id}/shapes: post: description: Adds a flowchart shape item to a board.

Required scope

boards:write

Rate limiting

Level 2
operationId: create-shape-item-flowchart parameters: - description: Unique identifier (ID) of the board where you want to create the item. in: path name: board_id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ShapeCreateRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/ShapeItem' description: Shape item created '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Create shape item tags: - Flowchart shapes (experimental) /v2-experimental/boards/{board_id}/shapes/{item_id}: get: description: Retrieves information for a specific shape item on a board.

Required scope

boards:read

Rate limiting

Level 1
operationId: get-shape-item-flowchart parameters: - description: Unique identifier (ID) of the board from which you want to retrieve a specific item. in: path name: board_id required: true schema: type: string - description: Unique identifier (ID) of the item that you want to retrieve. in: path name: item_id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ShapeItem' description: Shape item retrieved '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Get shape item tags: - Flowchart shapes (experimental) patch: description: Updates a flowchart shape item on a board based on the data and style properties provided in the request body.

Required scope

boards:write

Rate limiting

Level 2
operationId: update-shape-item-flowchart parameters: - description: Unique identifier (ID) of the board where you want to update the item. in: path name: board_id required: true schema: type: string - description: Unique identifier (ID) of the item that you want to update. in: path name: item_id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ShapeUpdateRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ShapeItem' description: Shape item updated '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Update shape item tags: - Flowchart shapes (experimental) delete: description: Deletes a flowchart shape item from the board.

Required scope

boards:write

Rate limiting

Level 3
operationId: delete-shape-item-flowchart parameters: - description: Unique identifier (ID) of the board from which you want to delete the item. in: path name: board_id required: true schema: type: string - description: Unique identifier (ID) of the item that you want to delete. in: path name: item_id required: true schema: type: string responses: '204': content: application/json: schema: type: object description: Shape item deleted '400': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Malformed request '404': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Not found '429': content: application/json: schema: type: object description: Test error obj properties: code: type: string description: Code of the error example: error message: type: string description: Description of the error example: Error message status: type: integer format: int32 description: Status code of the error example: 400 type: type: string description: Type of the error example: error description: Too many requests summary: Delete shape item tags: - Flowchart shapes (experimental) components: schemas: FrameData: type: object description: Contains frame item data, such as the title, frame type, or frame format. properties: format: type: string default: custom description: Only custom frames are supported at the moment. enum: - custom - desktop - phone - tablet - a4 - letter - ratio_1x1 - ratio_4x3 - ratio_16x9 title: type: string description: Title of the frame. This title appears at the top of the frame. example: Sample frame title type: type: string default: freeform description: Only free form frames are supported at the moment. enum: - freeform - heap - grid - rows - columns AppCardData: type: object description: Contains app card item data, such as the title, description, or fields. properties: description: type: string description: A short text description to add context about the app card. example: Sample app card description fields: type: array description: Array where each object represents a custom preview field. Preview fields are displayed on the bottom half of the app card in the compact view. items: $ref: '#/components/schemas/CustomField' owned: type: boolean description: Defines whether the card is owned by the application making the call. status: type: string description: Status indicating whether an app card is connected and in sync with the source. When the source for the app card is deleted, the status returns `disabled`. enum: - disconnected - connected - disabled title: type: string description: A short text header to identify the app card. example: sample app card item DocumentData: type: object properties: documentUrl: type: string description: 'The URL to download the resource. You must use your access token to access the URL. The URL contains the `redirect` parameter to control the request execution. `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. If 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 is `application/octet-stream`.' example: https://api.miro.com/v2/boards/uXjVOfjkmAk=/resources/98765467890987654?redirect=false title: type: string description: A short text header to identify the document. example: Sample document title ShapeDataForCreate: type: object description: Contains shape item data, such as the content or the type of the shape. properties: content: type: string description: "The text you want to display on the shape.\n
**Not supported for shapes:**\n" example: Hello shape: type: string default: rectangle description: "Defines the geometric shape of the item when it is rendered on the board.
\n Basic shapes\n \n
\n
\n Flowchart shapes\n \n
" 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. example: http://api.miro.com/v2/boards/o9J_koQspF4=/object_type/3074457349143649487 ShapeStyleForCreate: type: object description: "Contains information about the shape style, such as the border color or opacity.
All properties in style object are supported for shape types aren't listed below.
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Shape typeUnsupported properties
flow_chart_orfontSize, fontFamily, color, textAlign, textAlignVertical
flow_chart_summing_junctionfontSize, fontFamily, color, textAlign, textAlignVertical
flow_chart_note_curly_leftfillColor, fillOpacity
flow_chart_note_curly_rightfillColor, fillOpacity
flow_chart_note_squarefillColor, fillOpacity
" properties: borderColor: type: string description: 'Defines the color of the border of the shape. Default: `#1a1a1a` (dark gray).' borderOpacity: type: string description: 'Defines the opacity level of the shape border. Possible values: any number between `0.0` and `1.0`, where: `0.0`: the background color is completely transparent or invisible `1.0`: the background color is completely opaque or solid Default: `1.0` (solid color).' maximum: 1 minimum: 0 borderStyle: type: string description: 'Defines the style used to represent the border of the shape. Default: `normal`.' enum: - normal - dotted - dashed borderWidth: type: string description: 'Defines the thickness of the shape border, in dp. Default: `2.0`.' maximum: 24 minimum: 1 color: type: string description: 'Hex value representing the color for the text within the shape item. Default: `#1a1a1a`.' example: '#1a1a1a' fillColor: type: string description: 'Fill color for the shape. Hex values: `#f5f6f8` `#d5f692` `#d0e17a` `#93d275` `#67c6c0` `#23bfe7` `#a6ccf5` `#7b92ff` `#fff9b1` `#f5d128` `#ff9d48` `#f16c7f` `#ea94bb` `#ffcee0` `#b384bb` `#000000` Default: #ffffff.' example: '#8fd14f' fillOpacity: type: string description: 'Opacity level of the fill color. Possible values: any number between `0` and `1`, where: `0.0`: the background color is completely transparent or invisible `1.0`: the background color is completely opaque or solid Default: `Flowchart` shapes: `1.0`. `Basic` shapes: `1.0` if `fillColor` provided, `0.0` if no `fillColor` provided. ' maximum: 1 minimum: 0 fontFamily: type: string description: 'Defines the font type for the text in the shape item. Default: `arial`.' enum: - arial - abril_fatface - bangers - eb_garamond - georgia - graduate - gravitas_one - fredoka_one - nixie_one - open_sans - permanent_marker - pt_sans - pt_sans_narrow - pt_serif - rammetto_one - roboto - roboto_condensed - roboto_slab - caveat - times_new_roman - titan_one - lemon_tuesday - roboto_mono - noto_sans - plex_sans - plex_serif - plex_mono - spoof - tiempos_text - formular fontSize: type: string description: 'Defines the font size, in dp, for the text on the shape. Default: `14`.' maximum: 288 minimum: 10 textAlign: type: string description: 'Defines how the shape text is horizontally aligned. Default: Flowchart shapes: `center`. Basic shapes: `left`. `unknown` is returned for unsupported shapes.' enum: - left - right - center - unknown textAlignVertical: type: string description: 'Defines how the shape text is vertically aligned. Default: Flowchart shapes: `middle`. Basic shapes: `top`. `unknown` is returned for unsupported shapes.' enum: - top - middle - bottom - unknown createdBy: type: object description: Contains information about the user who created the item. properties: id: type: string description: Unique identifier (ID) of the user. example: '3458764517517852417' type: type: string description: Indicates the type of object returned. In this case, `type` returns `user`. example: user CardData: type: object description: Contains card item data, such as the title, description, due date, or assignee ID. properties: assigneeId: type: string format: int64 description: Unique user identifier. In the GUI, the user ID is mapped to the name of the user who is assigned as the owner of the task or activity described in the card. The identifier is numeric, and it is automatically assigned to a user when they first sign up. example: '3074457362577955300' description: type: string description: A short text description to add context about the card. example: sample card description dueDate: type: string format: date-time description: 'The date when the task or activity described in the card is due to be completed. In the GUI, users can select the due date from a calendar. 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)).' example: '2023-10-12T22:00:55.000Z' title: type: string description: A short text header for the card. example: sample card item GenericItemCursorPaged: type: object properties: data: type: array description: Contains the result data. items: $ref: '#/components/schemas/GenericItem' total: type: integer format: int64 description: Total number of results available. If the value of the `total` parameter is higher than the value of the `size` parameter, this means that there are more results that you can retrieve. To retrieve more results, you can make another request and set the `offset` value accordingly. For example, if there are `30` results, and the request has the `offset` set to `0` and the `limit` set to `20`, the `size` parameter will return `20` and the `total` parameter will return `30`. This means that there are 9 more results to retrieve (as the offset is zero-based). size: type: integer format: int32 description: Number of results returned in the response considering the `cursor` and the `limit` values sent in the request. For example, if there are `20` results, the request does not have a `cursor` value, and the `limit` set to `10`, the `size` of the results will be `10`.
In this example, the response will also return a cursor value that can be used to retrieve the next set of 10 remaining results in the collection. example: 1 cursor: type: string description: A cursor-paginated method returns a portion of the total set of results based on the `limit` specified and a `cursor` that points to the next portion of the results. To retrieve the next set of results of the collection, set the `cursor` parameter in your next request to the value returned in this parameter. example: MzQ1ODc2NDUyMjQ5MDA4Mjg5NX4= limit: type: integer format: int32 description: Maximum number of results returned based on the `limit` specified in the request. For example, if there are `20` results, the request has no `cursor` value, and the `limit` is set to `20`,the `size` of the results will be `20`. The rest of the results will not be returned. To retrieve the rest of the results, you must make another request and set the appropriate value for the `cursor` parameter value that you obtained from the response. example: 20 links: $ref: '#/components/schemas/PageLinks' ShapeCreateRequest: type: object properties: data: $ref: '#/components/schemas/ShapeDataForCreate' style: $ref: '#/components/schemas/ShapeStyleForCreate' position: $ref: '#/components/schemas/PositionChange' geometry: $ref: '#/components/schemas/Geometry' parent: $ref: '#/components/schemas/Parent' 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. example: 60 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. example: 320 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. example: '3458764517517852417' type: type: string description: Indicates the type of object returned. In this case, `type` returns `user`. example: user CustomField: type: object description: Array where each object represents a custom preview field. Preview fields are displayed on the bottom half of the app card in the compact view. properties: fillColor: type: string description: Hex value representing the color that fills the background area of the preview field, when it's displayed on the app card. example: '#2fa9e3' iconShape: type: string default: round description: The shape of the icon on the preview field. enum: - round - square iconUrl: type: string description: 'A valid URL pointing to an image available online. The transport protocol must be HTTPS. Possible image file formats: JPG/JPEG, PNG, SVG.' example: https://cdn-icons-png.flaticon.com/512/5695/5695864.png textColor: type: string description: Hex value representing the color of the text string assigned to `value`. example: '#1a1a1a' tooltip: type: string description: A short text displayed in a tooltip when clicking or hovering over the preview field. example: Completion status indicator value: type: string description: 'The actual data value of the custom field. It can be any type of information that you want to convey.' example: 'Status: in progress' 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. example: '3074457362577955300' links: $ref: '#/components/schemas/SelfLink' ShapeStyleForUpdate: type: object description: "Contains information about the shape style, such as the border color or opacity.
All properties in style object are supported for shape types aren't listed below.
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Shape typeUnsupported properties
flow_chart_orfontSize, fontFamily, color, textAlign, textAlignVertical
flow_chart_summing_junctionfontSize, fontFamily, color, textAlign, textAlignVertical
flow_chart_note_curly_leftfillColor, fillOpacity
flow_chart_note_curly_rightfillColor, fillOpacity
flow_chart_note_squarefillColor, fillOpacity
" properties: borderColor: type: string description: Defines the color of the border of the shape. borderOpacity: type: string description: 'Defines the opacity level of the shape border. Possible values: any number between `0.0` and `1.0`, where: `0.0`: the background color is completely transparent or invisible `1.0`: the background color is completely opaque or solid' maximum: 1 minimum: 0 borderStyle: type: string description: Defines the style used to represent the border of the shape. enum: - normal - dotted - dashed borderWidth: type: string description: Defines the thickness of the shape border, in dp. maximum: 24 minimum: 1 color: type: string description: Hex value representing the color for the text within the shape item. example: '#1a1a1a' fillColor: type: string description: 'Fill color for the shape. Hex values: `#f5f6f8` `#d5f692` `#d0e17a` `#93d275` `#67c6c0` `#23bfe7` `#a6ccf5` `#7b92ff` `#fff9b1` `#f5d128` `#ff9d48` `#f16c7f` `#ea94bb` `#ffcee0` `#b384bb` `#000000`' example: '#8fd14f' fillOpacity: type: string description: 'Opacity level of the fill color. Possible values: any number between `0` and `1`, where: `0.0`: the background color is completely transparent or invisible `1.0`: the background color is completely opaque or solid ' maximum: 1 minimum: 0 fontFamily: type: string description: Defines the font type for the text in the shape item. enum: - arial - abril_fatface - bangers - eb_garamond - georgia - graduate - gravitas_one - fredoka_one - nixie_one - open_sans - permanent_marker - pt_sans - pt_sans_narrow - pt_serif - rammetto_one - roboto - roboto_condensed - roboto_slab - caveat - times_new_roman - titan_one - lemon_tuesday - roboto_mono - noto_sans - plex_sans - plex_serif - plex_mono - spoof - tiempos_text - formular fontSize: type: string description: Defines the font size, in dp, for the text on the shape. maximum: 288 minimum: 10 textAlign: type: string description: Defines how the sticky note text is horizontally aligned. enum: - left - right - center textAlignVertical: type: string description: Defines how the sticky note text is vertically aligned. enum: - top - middle - bottom 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. Currently, 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. By default, all items have absolute positioning to the board, not the current viewport. Default: 0. The center point of the board has `x: 0` and `y: 0` coordinates.' example: 100 y: type: number format: double description: 'Y-axis coordinate of the location of the item on the board. By default, all items have absolute positioning to the board, not the current viewport. Default: 0. The center point of the board has `x: 0` and `y: 0` coordinates.' example: 100 ShapeDataForUpdate: type: object description: Contains shape item data, such as the content or the type of the shape. properties: content: type: string description: "The text you want to display on the shape.\n**Note: When updating a shape type to one of the types below, existing `content` will be lost.**\n
**Not supported for shapes:**\n" example: Hello shape: type: string default: rectangle description: "Defines the geometric shape of the item when it is rendered on the board.
\n Basic shapes\n \n
\n
\n Flowchart shapes\n \n
" GenericItem: type: object description: Contains the result data. properties: createdAt: type: string format: date-time description: 'Date and time when the item was created.
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)).' example: '2022-03-30T17:26:50.000Z' createdBy: $ref: '#/components/schemas/createdBy' data: $ref: '#/components/schemas/WidgetDataOutput' geometry: $ref: '#/components/schemas/Geometry' id: type: string description: Unique identifier (ID) of an item. example: '3458764517517819000' modifiedAt: type: string format: date-time description: 'Date and time when the item was last modified.
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)).' example: '2022-03-30T17:26:50.000Z' modifiedBy: $ref: '#/components/schemas/modifiedBy' parent: $ref: '#/components/schemas/Parent' position: $ref: '#/components/schemas/Position' type: type: string description: Type of item that is returned. example: sticky_note required: - id - type 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. example: http://api.miro.com/v2/boards/o9J_koQspF4=/items?parent_item_id=307445734914369434&limit=10&cursor= self: type: string description: Link to obtain information about the current item. example: http://api.miro.com/v2/boards/o9J_koQspF4=/item/3074457349143649487 TextData: type: object description: Contains text item data, such as the title, content, or description. For more information on the JSON properties, see [Data](https://developers.miro.com/reference/data). properties: content: type: string description: The actual text (content) that appears in the text item. example: Hello required: - content ShapeItem: type: object properties: id: type: string description: Unique identifier (ID) of an item. example: '3458764517517819000' data: $ref: '#/components/schemas/ShapeDataForCreate' style: $ref: '#/components/schemas/ShapeStyleForCreate' position: $ref: '#/components/schemas/Position' geometry: $ref: '#/components/schemas/Geometry' createdAt: type: string format: date-time description: 'Date and time when the item was created.
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)).' example: '2022-03-30T17:26:50.000Z' createdBy: $ref: '#/components/schemas/CreatedBy' modifiedAt: type: string format: date-time description: 'Date and time when the item was last modified.
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)).' example: '2022-03-30T17:26:50.000Z' modifiedBy: $ref: '#/components/schemas/ModifiedBy' parent: $ref: '#/components/schemas/ParentLinksEnvelope' links: $ref: '#/components/schemas/WidgetLinks' type: type: string description: Type of item that is returned. example: shape required: - id - type EmbedData: type: object properties: contentType: type: string description: Type of the embedded item's content. example: video description: type: string description: Short description of the embedded item. example: So this is how to organize your life with Miro (a virtual whiteboard) for collaboration, brainstorming, and project management. Students, designers, agile en... html: type: string description: Html code of the embedded item. example: mode: type: string description: 'Defines how the content in the embed item is displayed on the board. `inline`: The embedded content is displayed directly on the board. `modal`: The embedded content is displayed inside a modal overlay on the board.' enum: - inline - modal previewUrl: type: string description: 'The URL to download the resource. You must use your access token to access the URL. The URL contains the `redirect` parameter and the `format` parameter to control the request execution as described in the following parameters: `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`. `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. If 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.' example: https://api.miro.com/v2/boards/uXjVOfjkmAk=/resources/98765467890987654?format=preview&redirect=false providerName: type: string description: Name of the content's provider. example: YouTube providerUrl: type: string description: Url of the content's provider. example: https://www.youtube.com/ title: type: string description: Title of the embedded item. example: HOW TO ORGANIZE YOUR LIFE WITH MIRO! ✏ Virtual Whiteboard Tour url: type: string description: 'A [valid URL](https://developers.miro.com/reference/data#embeddata) pointing to the content resource that you want to embed in the board. Possible transport protocols: HTTP, HTTPS.' example: https://www.youtube.com/watch?v=HlVSNEiFCBk Parent: 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. example: '3074457362577955300' WidgetDataOutput: type: object description: Contains the item data, such as the item title, content, or description. oneOf: - $ref: '#/components/schemas/TextData' - $ref: '#/components/schemas/EmbedData' - $ref: '#/components/schemas/CardData' - $ref: '#/components/schemas/AppCardData' - $ref: '#/components/schemas/ImageData' - $ref: '#/components/schemas/DocumentData' - $ref: '#/components/schemas/ShapeData' - $ref: '#/components/schemas/FrameData' - $ref: '#/components/schemas/StickyNoteData' PageLinks: type: object description: Contains pagination links for the collection. properties: first: type: string description: Link to retrieve information in the first page of the collection. example: http://api.miro.com/v2/boards/o9J_lJWSHdg=/items?limit=10&cursor=MzQ1ODc2NaSDN&#RDMDA3MzYyOX== last: type: string description: Link to the retrieve information in the last page of the collection. example: http://api.miro.com/v2/boards/o9J_lJWSHdg=/items?limit=10&cursor=MzQ1ODc2NDUyNDUyMDA3MzYyOX== next: type: string description: Link to retrieve information in the next page of the collection. example: http://api.miro.com/v2/boards/o9J_lJWSHdg=/items?limit=10&cursor=MzQ1ODc2NDUyNDsdgsFEwfFJCw== prev: type: string description: Link to retrieve information in the previous page of the collection. example: http://api.miro.com/v2/boards/o9J_lJWSHdg=/items?limit=10&cursor= self: type: string description: Link to retrieve information in the current page of the collection. example: http://api.miro.com/v2/boards/o9J_lJWSHdg=/items?limit=10&cursor=MzQ1OD1245643FWUyMDA3MzYyOX== PositionChange: type: object description: Contains information about the item's position on the board, such as its `x` coordinate, `y` coordinate, and the origin of the `x` and `y` coordinates. properties: x: type: number format: double description: 'X-axis coordinate of the location of the item on the board. By default, all items have absolute positioning to the board, not the current viewport. Default: `0`. The center point of the board has `x: 0` and `y: 0` coordinates.' default: 0 example: 100 y: type: number format: double description: 'Y-axis coordinate of the location of the item on the board. By default, all items have absolute positioning to the board, not the current viewport. Default: `0`. The center point of the board has `x: 0` and `y: 0` coordinates.' default: 0 example: 100 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. example: '3458764517517852417' type: type: string description: Indicates the type of object returned. In this case, `type` returns `user`. example: user ShapeData: type: object description: Contains shape item data, such as the content or shape type of the shape. properties: content: type: string description: The text you want to display on the shape. example: Hello shape: type: string default: rectangle description: Defines the geometric shape of the item when it is rendered on the board. enum: - rectangle - round_rectangle - circle - triangle - rhombus - parallelogram - trapezoid - pentagon - hexagon - octagon - wedge_round_rectangle_callout - star - flow_chart_predefined_process - cloud - cross - can - right_arrow - left_arrow - left_right_arrow - left_brace - right_brace StickyNoteData: type: object description: Contains sticky note item data, such as the content or shape of the sticky note. properties: content: type: string description: The actual text (content) that appears in the sticky note item. example: Hello shape: type: string default: square description: Defines the geometric shape of the sticky note and aspect ratio for its dimensions. enum: - square - rectangle ShapeUpdateRequest: type: object properties: data: $ref: '#/components/schemas/ShapeDataForUpdate' style: $ref: '#/components/schemas/ShapeStyleForUpdate' position: $ref: '#/components/schemas/PositionChange' geometry: $ref: '#/components/schemas/Geometry' parent: $ref: '#/components/schemas/Parent' CreatedBy: type: object description: Contains information about the user who created the item. properties: id: type: string description: Unique identifier (ID) of the user. example: '3458764517517852417' type: type: string description: Indicates the type of object returned. In this case, `type` returns `user`. example: user ImageData: type: object properties: imageUrl: type: string description: 'The URL to download the resource. You must use your access token to access the URL. The URL contains the `redirect` parameter and the `format` parameter to control the request execution as described in the following parameters: `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`. `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. If 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.' example: https://api.miro.com/v2/boards/uXjVOfjkmAk=/resources/98765467890987654?format=preview&redirect=false title: type: string description: A short text header to identify the image. example: Sample image title securitySchemes: oAuth2AuthCode: type: oauth2 description: For more information, see https://developers.miro.com/reference/authorization-flow-for-expiring-tokens flows: authorizationCode: authorizationUrl: https://miro.com/oauth/authorize tokenUrl: https://api.miro.com/v1/oauth/token scopes: boards:read: Retrieve information about boards, board members, or items boards:write: Create, update, or delete boards, board members, or items microphone:listen: Access a user's microphone to record audio in an iFrame screen:record: Access a user's screen to record it in an iFrame webcam:record: Allows an iFrame to access a user's camera to record video organizations:read: Read information about the organization, such as name, plan, number of licenses, organization settings, or organization members. organizations:teams:read: Read team information, such as the list of teams, team settings, team members, for an organization. organizations:teams:write: Create or delete teams, update team information, team settings, team members, for an organization. x-settings: publish: true