Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Audit API syntax for complex filtering?

    Posted 04-03-2025 15:36

    I have a use case where I want to track changes to Queue configurations.  I want to omit membership update changes, as those are quite noisy.

    /api/v2/audits/query/realtime

    Using this API, I seem to only be able to grab all queue events

    {
      "serviceName": "ContactCenter",
      "interval": "2025-04-01T00:00:00Z/2025-04-03T00:00:00Z",
      "filters": [
        {
          "property": "EntityType",
          "value": "Queue"
        }
      ]
    }

    , or only be able to filter by each action one at a time (Add, Update, Delete).

    {
      "serviceName": "ContactCenter",
      "interval": "2025-04-01T00:00:00Z/2025-04-03T00:00:00Z",
      "filters": [
        {
          "property": "EntityType",
          "value": "Queue"
        },
        {
          "property": "Action",
          "value": "Update"
        }
      ]
    }

    If I try to add more `Action` filters, the API fails the request noting only one at a time are allowed.  It doesn't support a comma-separated list of Actions, either.

    Is there a better way to do this than calling this API 3 times, for the 3 actions I care about?


    #PlatformAPI

    ------------------------------
    Paul McGurn
    Senior Manager, Telecom & DevOps
    Persistent Systems
    ------------------------------


  • 2.  RE: Audit API syntax for complex filtering?

    Posted 04-04-2025 09:23

    Hi Paul,

    At this point our audit APIs do not support more complex filtering than a single value per property. Querying for three separate actions will require three separate queries.

    We continue to improve on our audit capabilities based on feedback such as yours, and your input helps us prioritize future enhancements.

    Thanks for reaching out.



    ------------------------------
    Andy Kauffman
    Genesys - Employees
    Director of Development - Platform Troubleshooting
    ------------------------------

    Original Message


Related Content