POST /api/v2/conversations/cobrowse failing with 400 on sessionInitiator

NICE CXone API & Integrations
1

Trying to kick off a cobrowse session via the API. The docs state: “To start a cobrowse session, POST to /api/v2/conversations/cobrowse with a valid conversationId and agentId.”

I’ve got a valid call conversation ID and an authenticated agent token. The request looks right.

POST /api/v2/conversations/cobrowse
{
 "conversationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 "agentId": "f9e8d7c6-b5a4-3210-fedc-ba0987654321"
}

Getting a 400 Bad Request. The error payload says:

{
 "message": "sessionInitiator is required but not provided",
 "errors": [
 {
 "message": "sessionInitiator is required"
 }
 ]
}

The docs don’t mention sessionInitiator in the request body schema for this endpoint. I’ve checked the swagger definition too. It’s not there.

  • Using genesys-cloud-python SDK v2.0.14
  • Token has cobrowse:write scope
  • Agent is in a queue with cobrowse capability enabled
  • Tried adding "sessionInitiator": "agent" to the body, still 400 but now complains about unknown field

What am I missing? Is the doc outdated?