Consultar roles de empleado disponibles

Este endpoint permite consultar los roles de empleado disponibles en un servicio.

GET /api/v1/businesses/{businessId}/services/{serviceId}/employee-roles

Si los datos incluidos en la petición son correctos —businessId y serviceId—, la respuesta contendrá el listado de roles definidos a nivel de servicio. Por ejemplo:

[
    {
        "orquestId": 13358,
        "name": "Commercial",
        "color": "#fad0e4"
    },
    {
        "id": "ID001",
        "orquestId": 19985,
        "name": "Manager",
        "color": "#921b01"
    }
]

La petición devuelve la lista de roles de empleados definidos para el servicio tal y como se hayan configurado en Orquest. Por ejemplo, si un rol no tiene identificador externo configurado, la petición no podrá devolver ese dato.

Aspectos que tener en cuenta

Si no hay roles para el servicio, la petición devolverá un array vacío [].

Si el servicio no existe, la petición devolverá un error 404 Not Found indicando not exists.

Enlaces de interés

¿Qué es un rol de empleado?