CXone Admin API Bulk Update Agent Skills 400 Bad Request

Trying to bulk-update agent skill proficiencies via the CXone Admin API. I’m sending a POST to /api/v2/users/skills/bulkupdate. The request body is a simple JSON array with userId and proficiency fields. I keep getting a 400 Bad Request. Here’s the payload:

[{"userId": "12345", "skillId": "67890", "proficiency": 5}]

The docs aren’t clear on the exact schema. Is the structure wrong or do I need a different endpoint?

You’re sending a raw array, but the endpoint expects a JSON object wrapping that array in a data property. Try this structure instead:

{
 "data": [
 {
 "userId": "12345",
 "skillId": "67890",
 "proficiency": 5
 }
 ]
}