I’m trying to automate skill proficiency updates for a batch of agents using the CXone Admin API. Specifically, I’m hitting the PUT /api/v2/users/{userId}/skills endpoint. The goal is to update multiple skill proficiencies in a single request to avoid rate limits.
Here’s the payload I’m sending:
[
{
"skillId": "12345",
"proficiency": 5
},
{
"skillId": "67890",
"proficiency": 3
}
]
The request returns a 409 Conflict with the message: “One or more skills are already assigned to the user with a different proficiency.”
I’ve checked the documentation, and it seems like the API expects an upsert operation, but the error suggests it’s treating this as a duplicate key conflict rather than an update. I’ve tried adding the X-Correlation-Id header, but that didn’t change the outcome.
Has anyone successfully bulk-updated skill proficiencies via the Admin API? Is there a specific header or query parameter I’m missing? Or is the only way to do this by calling the endpoint for each skill individually?
I’ve also tried using the PATCH method, but that doesn’t seem to be supported for this endpoint. Any insights or workarounds would be appreciated. I’m currently falling back to a script that iterates through each agent and skill, but it’s slow and prone to timeout errors.