I am attempting to automate agent skill proficiency updates using the CXone Admin API. The goal is to push a batch of updates via the /api/v2/users endpoint using the PUT method with a JSON payload containing user IDs and their corresponding skill proficiencies.
The request structure looks like this:
[
{
"id": 123456,
"skillProficiencies": [
{ "skillId": 789, "proficiency": "expert" }
]
}
]
I am receiving a 400 Bad Request error. The response body indicates that the skillProficiencies array format is invalid, yet it matches the schema documented for single-user updates. I have verified the OAuth token has the users:skillproficiency:write scope. The issue seems to arise specifically when batching multiple users in a single call rather than looping through them individually. Is there a specific wrapper object required for the bulk operation, or is the endpoint rejecting the array directly? I have tried wrapping the array in a users key, but that results in a 404. The documentation is sparse on bulk mutation examples for this specific resource.