CXone Admin API bulk update agent skills returns 200 OK but no changes

NICE CXone API & Integrations
1

Trying to bulk update skill proficiencies for a batch of agents using the CXone Admin API. The docs for PATCH /api/v2/admin/agents say this endpoint supports partial updates and should handle skill assignments.

I’m sending a JSON payload like this:

{
 "agents": [
 {
 "id": "a1b2c3d4-...",
 "skills": [
 {
 "id": "skill-xyz-123",
 "proficiency": "expert"
 }
 ]
 }
 ]
}

The request returns a 200 OK with an empty response body. No errors thrown. But when I fetch the agent details via GET /api/v2/admin/agents/{id}, the proficiency hasn’t changed. It stays at “novice”.

I’ve checked the OAuth token has admin:agent:write scope. The divisionId header is set correctly. I’m using .NET HttpClient with HttpMethod.Patch.

Is the payload structure wrong? Or is bulk skill updating not actually supported on this endpoint despite the docs implying it? The documentation snippet says:

“Partial updates can be performed by sending only the properties you wish to update.”

But maybe skills are excluded from partial updates? Tried sending the full agent object with all fields, still no change.

2

Docs state: “To update agent skills, use PATCH /api/v2/agents/{agentId}.” There is no bulk endpoint. You’ll need to loop through the IDs.