{
  "opencollection": "1.0.0",
  "info": {
    "name": "Miro Developer Platform AI Interaction Logs tags API",
    "version": "v2.0"
  },
  "items": [
    {
      "info": {
        "name": "tags",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get tags from item",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.miro.com/v2/boards/:board_id/items/:item_id/tags",
            "params": [
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board with the item whose tags you want to retrieve."
              },
              {
                "name": "item_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the item whose tags you want to retrieve."
              }
            ]
          },
          "docs": "Retrieves all the tags from the specified item.<br/><h3>Required scope</h3> <a target=_blank href=https://developers.miro.com/reference/scopes>boards:read</a> <br/><h3>Rate limiting</h3> <a target=_blank href=\"/reference/rate-limiting#rate-limit-tiers\">Level 1</a><br/>"
        },
        {
          "info": {
            "name": "Get tags from board",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.miro.com/v2/boards/:board_id/tags",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query"
              },
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board whose tags you want to retrieve."
              }
            ]
          },
          "docs": "Retrieves all the tags from the specified board.<br/><h3>Required scope</h3> <a target=_blank href=https://developers.miro.com/reference/scopes>boards:read</a> <br/><h3>Rate limiting</h3> <a target=_blank href=\"/reference/rate-limiting#rate-limit-tiers\">Level 1</a><br/>"
        },
        {
          "info": {
            "name": "Create tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.miro.com/v2/boards/:board_id/tags",
            "params": [
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board where you want to create the tag."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a tag on a board.<br/><h3>Required scope</h3> <a target=_blank href=https://developers.miro.com/reference/scopes>boards:write</a> <br/><h3>Rate limiting</h3> <a target=_blank href=\"/reference/rate-limiting#rate-limit-tiers\">Level 1</a><br/>"
        },
        {
          "info": {
            "name": "Get tag",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.miro.com/v2/boards/:board_id/tags/:tag_id",
            "params": [
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board where you want to retrieve a specific tag."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the tag that you want to retrieve."
              }
            ]
          },
          "docs": "Retrieves information for a specific tag.<br/><h3>Required scope</h3> <a target=_blank href=https://developers.miro.com/reference/scopes>boards:write</a> <br/><h3>Rate limiting</h3> <a target=_blank href=\"/reference/rate-limiting#rate-limit-tiers\">Level 1</a><br/>"
        },
        {
          "info": {
            "name": "Update tag",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.miro.com/v2/boards/:board_id/tags/:tag_id",
            "params": [
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board where you want to update a specific tag."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the tag that you want to update."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates a tag based on the data properties provided in the request body. <br><blockquote><strong>Note:</strong> Updates to tags made via the REST API  will not be reflected on the board in realtime. To see REST API updates to tags on a board,  you need to refresh the board. This applies to the following endpoints:  [Attach tag to item](https://developers.miro.com/reference/attach-tag-to-item),  [Remove tag from item](https://developers.miro.com/reference/remove-tag-from-item),   [Delete tag](htt"
        },
        {
          "info": {
            "name": "Delete tag",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.miro.com/v2/boards/:board_id/tags/:tag_id",
            "params": [
              {
                "name": "board_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board where you want to delete a specific tag."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the tag that you want to delete."
              }
            ]
          },
          "docs": "Deletes the specified tag from the board. The tag is also removed from all cards and sticky notes on the board. <br><blockquote><strong>Note:</strong> Updates to tags made via the REST API  will not be reflected on the board in realtime. To see REST API updates to tags on a board,  you need to refresh the board. This applies to the following endpoints:  [Attach tag to item](https://developers.miro.com/reference/attach-tag-to-item),  [Remove tag from item](https://developers.miro.com/reference/re"
        },
        {
          "info": {
            "name": "Get items by tag",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.miro.com/v2/boards/:board_id_PlatformTags/items",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query"
              },
              {
                "name": "board_id_PlatformTags",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board where you want to retrieve a specific tag."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "query",
                "description": "Unique identifier (ID) of the tag that you want to retrieve."
              }
            ]
          },
          "docs": "Retrieves all the items that have the specified tag.<br/><h3>Required scope</h3> <a target=_blank href=https://developers.miro.com/reference/scopes>boards:read</a> <br/><h3>Rate limiting</h3> <a target=_blank href=\"/reference/rate-limiting#rate-limit-tiers\">Level 1</a><br/>"
        },
        {
          "info": {
            "name": "Attach tag to item",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.miro.com/v2/boards/:board_id_PlatformTags/items/:item_id",
            "params": [
              {
                "name": "board_id_PlatformTags",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board with the item that you want to add a tag to."
              },
              {
                "name": "item_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the item to which you want to add a tag."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "query",
                "description": "Unique identifier (ID) of the tag you want to add to the item."
              }
            ]
          },
          "docs": "Attach an existing tag to the specified item. Card and sticky note items can have up to 8 tags. <br><blockquote><strong>Note:</strong> Updates to tags made via the REST API  will not be reflected on the board in realtime. To see REST API updates to tags on a board,  you need to refresh the board. This applies to the following endpoints:   [Remove tag from item](https://developers.miro.com/reference/remove-tag-from-item),  [Update tag](https://developers.miro.com/reference/update-tag),  [Delete t"
        },
        {
          "info": {
            "name": "Remove tag from item",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.miro.com/v2/boards/:board_id_PlatformTags/items/:item_id",
            "params": [
              {
                "name": "board_id_PlatformTags",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the board with the item that you want to remove a tag from."
              },
              {
                "name": "item_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier (ID) of the item that you want to remove the tag from."
              },
              {
                "name": "tag_id",
                "value": "",
                "type": "query",
                "description": "Unique identifier (ID) of the tag that you want to remove from the item."
              }
            ]
          },
          "docs": "Removes the specified tag from the specified item. The tag still exists on the board. <br><blockquote><strong>Note:</strong> Updates to tags made via the REST API  will not be reflected on the board in realtime. To see REST API updates to tags on a board,  you need to refresh the board. This applies to the following endpoints:  [Attach tag to item](https://developers.miro.com/reference/attach-tag-to-item),   [Update tag](https://developers.miro.com/reference/update-tag),  [Delete tag](https://de"
        }
      ]
    }
  ],
  "bundled": true
}