Cobrowse session initiation via Conversations API

NICE CXone API & Integrations
1

Why does this setting fail?

Background

I need to trigger a cobrowse session programmatically from an external service, bypassing the standard agent UI flow.

Issue

Calling POST /api/v2/conversations/{conversationId}/cobrowse with the routing:conversation:write scope returns 400 Bad Request. The payload is minimal:

{
 "sessionId": "sess-123",
 "initiatedBy": "external"
}

Troubleshooting

  • Verified the token has cobrowse:session:write.
  • Confirmed the conversationId is active and of type cobrowse.
  • The error body is empty, no specific field validation messages returned.