Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  WFM Agent API missing

    Posted 20 days ago

    Hi,

    I'm looking to retrieve the WFM agent configuration for a business unit-specifically, the planning groups they belong to.

    Based on the API calls I analyzed from the WFM page: Planning Groups > <My Planning Group> > Agents, the following API endpoint is used:
    /api/v2/workforcemanagement/managementunits/{managementUnitId}/agents

    This endpoint appears to allow retrieving, for all agents within a management unit, the agents including their skills and queues.

    Calls are of course made for each management unit within the business unit, and that approach works for me. The issue is that this API endpoint is not present in the documentation (nor in the SDK).

    Only the following endpoint seems to exist:
    /api/v2/workforcemanagement/managementunits/{managementUnitId}/agents/{agentId}
    However, it would require making one API call per agent.

    Could you please confirm whether this is a documentation mistake, or if there is a specific reason for it (for example an internal/restricted/non-public API)?

    In my view, having an endpoint to fetch all agents for a management unit in one go is necessary to make this task straightforward.

    Thank you in advance for your answers.

    Kind regards,


    #PlatformAPI
    #PlatformSDK

    ------------------------------
    Stéphane Labrune
    NA
    ------------------------------


  • 2.  RE: WFM Agent API missing

    Posted 18 days ago

    Hey so looked into this and the route you found is intentionally marked "internal" in our system and reverse engineering it is not recomended for customer api usage. 

    You can get skill and language information for users with the appropriate expands using this route:

    POST /api/v2/users/search](https://developer.genesys.cloud/useragentman/users/#post-api-v2-users-search

    Queue membership is a little trickier as I'm not finding a route that takes a list of user and returns queue associations looking through the api docs.

    Can you give us a little more information on how you're wanting to use this data so we can maybe help point you towards a solution that works for you?



    ------------------------------
    Brian Trezise
    Genesys - Employees - Lead Software Engineer
    ------------------------------