def set_overlays_priorities(
    self,
    overlay_prioirty: dict,
) -> dict:
    """Set overlay priorities. This affects the order of the different
    overlays' route maps. Keys are overlay priority, values are the
    overlay id numbers.

    .. list-table::
        :header-rows: 1

        * - Swagger Section
          - Method
          - Endpoint
        * - overlays
          - POST
          - /gms/overlays/priority

    .. code::

        overlay_prioirty = {
            "1": 5,
            "2": 6,
            "3": 7,
        }

    In the example above, Overlay 5 has 1st priority, Overlay 6 is 2nd,
    and Overlay 7 is 3rd.

    .. note::

        Each overlay ID must have a unique priority. This function will
        overwrite existing priorities so it is best to first run
        :func:`~get_overlays_priorities` to account for all current
        overlay priorities.

    :return: Returns dictionary of overlay priority \n
    :rtype: dict
    """
    return self._post(
        "/gms/overlays/priority",
        data=overlay_prioirty,
        expected_status=[204],
        return_type="bool",
    )