Genesys Cloud - Main

 View Only

Sign Up

  • 1.  Skill add/remove in Audit API

    Posted 28 days ago

    Hi everyone,

    Quick question, whenever a skill is added or deleted, is it recorded in audit viewer? 

    Not added or removed for user/group, I mean added/deleted as a entity.


    #API/Integrations

    ------------------------------
    Abdullah Aslam
    Senior Software Delivery, Integration Specalist
    ------------------------------


  • 2.  RE: Skill add/remove in Audit API
    Best Answer

    Posted 28 days ago

    Hello Abdullah,

    I know that the audit viewer can track when a skill is assigned or removed form a user, but I'm not 100% sure if we show the creation and deletion of skills in the Audit Viewer. If you need to know who deleted a skill and when, I would recommend reaching out to Product Support to investigate the logs on the backend.



    ------------------------------
    Jason Kleitz
    Online Community Manager/Moderator
    ------------------------------



  • 3.  RE: Skill add/remove in Audit API

    Posted 28 days ago
    Edited by Abdullah Aslam 28 days ago

    Thank you for answering. Actually I need a list of all skills added/deleted in the last year. So I'm not sure if Product Support would be able to help. But I believe this should be present in the Audit Viewer/API. 



    ------------------------------
    Abdullah Aslam
    Senior Software Delivery, Integration Specalist
    ------------------------------



  • 4.  RE: Skill add/remove in Audit API

    Posted 28 days ago

    Hi @Abdullah Aslam,

    You can retrive this using the API /api/v2/audits/query

    Here is a sample body to use.

    {
      "interval": "2025-08-21T03:00:00/2025-08-22T03:00:00",
      "serviceName": "Presence",
      "filters": [
        {
          "property": "EntityType",
          "value": "UserPresence"
        }
      ]
    }

    in the result, get the ID and then run this /api/v2/audits/query/{transactionId}/results (set expand user to get details about how changed it).


    You should be able to get results like this:

    {
      "id": "57e32c34-87e0-425d-8617-e8c120bf4a82",
      "pageSize": 2,
      "cursor": "ATgqEA/k3SYo1DjacP4dMF8qAJSeFD321jMD3xzFnX+lOo7zrQGEdb0AvdwblIlPrJHwz9yaGl9xuMbSYWlrcCV5swjros4zDw==",
      "entities": [
        {
          "id": "9b40133f-74aa-4c2b-8916-837af436a30c",
          "user": {},
          "client": {
            "id": ""
          },
          "remoteIp": [],
          "serviceName": "Presence",
          "level": "SYSTEM",
          "eventDate": "2025-08-21T03:07:25Z",
          "action": "Update",
          "entity": {
            "id": "0f7035b8-6596-45da-8300-320c4c3eb7c4",
            "name": "0f7035b8-6596-45da-8300-320c4c3eb7c4"
          },
          "entityType": "UserPresence",
          "status": "SUCCESS",
          "application": "",
          "initiatingAction": {},
          "transactionInitiator": false,
          "propertyChanges": [
            {
              "property": "PRESENCE",
              "oldValues": [
                "Available"
              ],
              "newValues": [
                "Offline"
              ]
            }
          ],
          "context": {},
          "entityChanges": []
        },
        {
          "id": "249bd26d-d3b9-48b0-88b9-6ee3954e2f66",
          "user": {},
          "client": {
            "id": ""
          },
          "remoteIp": [],
          "serviceName": "Presence",
          "level": "SYSTEM",
          "eventDate": "2025-08-21T10:53:29Z",
          "action": "Update",
          "entity": {
            "id": "19aa31d0-1e32-4f20-a0c3-37df1fc7451b",
            "name": "19aa31d0-1e32-4f20-a0c3-37df1fc7451b"
          },
          "entityType": "UserPresence",
          "status": "SUCCESS",
          "application": "",
          "initiatingAction": {},
          "transactionInitiator": false,
          "propertyChanges": [
            {
              "property": "PRESENCE",
              "oldValues": [
                "Offline"
              ],
              "newValues": [
                "Available"
              ]
            }
          ],
          "context": {},
          "entityChanges": []
        }
      ]
    }



    ------------------------------
    Debora Lopes
    ------------------------------



  • 5.  RE: Skill add/remove in Audit API

    Posted 28 days ago

    Hi @Debora Lopes,

    I think you are talking about something different. My requirement is to get a list of skills added/removed in my org, not assigned/removed to a user/group. 



    ------------------------------
    Abdullah Aslam
    Senior Software Delivery, Integration Specalist
    ------------------------------



  • 6.  RE: Skill add/remove in Audit API

    Posted 28 days ago

    Oh, I miss read you post, I'm sorry.

    There is some information about the Audit API here:
    https://developer.genesys.cloud/platform/audit/
    https://developer.genesys.cloud/platform/audit/auditquerycreate
    https://developer.genesys.cloud/platform/audit/actioncatalog

    Here is informing that the API retains only 365 days of audit logs.
    https://developer.genesys.cloud/platform/audit/auditwiki



    ------------------------------
    Debora Lopes
    ------------------------------



  • 7.  RE: Skill add/remove in Audit API

    Posted 28 days ago

    Hi,

    I tested this and there's no Audit for creating or deleting skills, I also tested this with the Audit Query API which gives more results but nothing there.

    There's several ideas to have this implemented, for example https://genesyscloud.ideas.aha.io/ideas/AMPST-I-158 but nothing in development at the moment from what I've found.



    ------------------------------
    Jan Heinonen
    Contact Center Specialist
    GlobalConnect AB
    ------------------------------