{
  "opencollection": "1.0.0",
  "info": {
    "name": "Channel Accounts Tags API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Tags",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List company tags",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/company/tags",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max number of results per [page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "page_token",
                "value": "",
                "type": "query",
                "description": "Token to use to request the [next page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "sort_by",
                "value": "",
                "type": "query",
                "description": "Field used to sort the tags. Only supports `id`."
              },
              {
                "name": "sort_order",
                "value": "",
                "type": "query",
                "description": "Order by which results should be sorted"
              }
            ]
          },
          "docs": "List the company tags.\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Create company tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api2.frontapp.com/company/tags",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a company tag.\n\nRequired scope: `tags:write`"
        },
        {
          "info": {
            "name": "List tags",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/tags",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max number of results per [page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "page_token",
                "value": "",
                "type": "query",
                "description": "Token to use to request the [next page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "sort_by",
                "value": "",
                "type": "query",
                "description": "Field used to sort the tags. Only supports `id`."
              },
              {
                "name": "sort_order",
                "value": "",
                "type": "query",
                "description": "Order by which results should be sorted"
              }
            ]
          },
          "docs": "List all the tags of the company that the API token has access to, whether they be company tags, team tags, or teammate tags.\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Create tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api2.frontapp.com/tags",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a tag in the oldest team (workspace). This is a legacy endpoint. Use the Create company tag, Create team tag, or Create teammate tag endpoints instead.\n\nRequired scope: `tags:write`"
        },
        {
          "info": {
            "name": "Get tag",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/tags/:tag_id",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The tag ID"
              }
            ]
          },
          "docs": "Fetch a tag.\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Update a tag",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api2.frontapp.com/tags/:tag_id",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The tag ID"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update a tag.\n\nRequired scope: `tags:write`"
        },
        {
          "info": {
            "name": "Delete tag",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api2.frontapp.com/tags/:tag_id",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The ID of the tag to delete"
              }
            ]
          },
          "docs": "Delete a tag.\n\nRequired scope: `tags:delete`"
        },
        {
          "info": {
            "name": "List tag children",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/tags/:tag_id/children",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The tag ID"
              }
            ]
          },
          "docs": "List the children of a specific tag.\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Create child tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api2.frontapp.com/tags/:tag_id/children",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The tag ID"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a child tag.\n\nRequired scope: `tags:write`"
        },
        {
          "info": {
            "name": "List tagged conversations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/tags/:tag_id/conversations",
            "params": [
              {
                "name": "tag_id",
                "value": "",
                "type": "path",
                "description": "The ID of the tag"
              },
              {
                "name": "q",
                "value": "",
                "type": "query",
                "description": "[Search query object](https://dev.frontapp.com/docs/query-object-q) with a property `statuses`, whose value should be a list of conversation statuses (`assigned`, `unassigned`, `archived`, or `trashed`). If ticketing is enabled, this endpoint accepts either `status_categories` (`open`, `waiting`, `resolved`) or `status_ids` as an alternative."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max number of results per [page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "page_token",
                "value": "",
                "type": "query",
                "description": "Token to use to request the [next page](https://dev.frontapp.com/docs/pagination)"
              }
            ]
          },
          "docs": "List the conversations tagged with a tag. For more advanced filtering, see the [search endpoint](https://dev.frontapp.com/reference/conversations#search-conversations).\n\n\nRequired scope: `conversations:read`"
        },
        {
          "info": {
            "name": "List teammate tags",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/teammates/:teammate_id/tags",
            "params": [
              {
                "name": "teammate_id",
                "value": "",
                "type": "path",
                "description": "The teammate ID. Alternatively, you can supply an email as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max number of results per [page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "page_token",
                "value": "",
                "type": "query",
                "description": "Token to use to request the [next page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "sort_by",
                "value": "",
                "type": "query",
                "description": "Field used to sort the tags. Only supports `id`."
              },
              {
                "name": "sort_order",
                "value": "",
                "type": "query",
                "description": "Order by which results should be sorted"
              }
            ]
          },
          "docs": "List the tags for a teammate.\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Create teammate tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api2.frontapp.com/teammates/:teammate_id/tags",
            "params": [
              {
                "name": "teammate_id",
                "value": "",
                "type": "path",
                "description": "The teammate ID. Alternatively, you can supply an email as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1)."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a tag for a teammate.\n\nRequired scope: `tags:write`"
        },
        {
          "info": {
            "name": "List team tags",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api2.frontapp.com/teams/:team_id/tags",
            "params": [
              {
                "name": "team_id",
                "value": "",
                "type": "path",
                "description": "The team ID"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max number of results per [page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "page_token",
                "value": "",
                "type": "query",
                "description": "Token to use to request the [next page](https://dev.frontapp.com/docs/pagination)"
              },
              {
                "name": "sort_by",
                "value": "",
                "type": "query",
                "description": "Field used to sort the tags. Only supports `id`."
              },
              {
                "name": "sort_order",
                "value": "",
                "type": "query",
                "description": "Order by which results should be sorted"
              }
            ]
          },
          "docs": "List the tags for a team (workspace).\n\nRequired scope: `tags:read`"
        },
        {
          "info": {
            "name": "Create team tag",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api2.frontapp.com/teams/:team_id/tags",
            "params": [
              {
                "name": "team_id",
                "value": "",
                "type": "path",
                "description": "The team ID"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a tag for a team (workspace).\n\nRequired scope: `tags:write`"
        }
      ]
    }
  ],
  "bundled": true
}