CallQueuePresenceEventBody does not match Call Queue Member Presence Event payload

[mtherriault]

CallQueuePresenceEventBody does not match Call Queue Member Presence Event payload

Problem

The current CallQueuePresenceEventBody model does not match the documented payload for the Call Queue Member Presence Event, nor the payload we receive from RingCentral.

Current SDK model:

public class CallQueuePresenceEventBody
{
    public string extensionId { get; set; }
    public string callQueueId { get; set; }
    public bool? acceptCalls { get; set; }
}

Source:

https://github.com/ringcentral/RingCentral.Net/blob/master/RingCentral.Net/Definitions/CallQueuePresenceEventBody.cs

According to the RingCentral documentation for the Call Queue Member Presence Event, the notification body contains a records array, where each record contains a member object and acceptCurrentQueueCalls.

Documentation:

https://developers.ringcentral.com/api-reference/Call-Queue-Member-Presence-Event

Documented / received payload shape

{
  "uuid": "ed1cf00c-0420-4bf5-a0ae-e659cc9f77e0",
  "event": "/restapi/v1.0/account/{accountId}/call-queues/{groupId}/presence",
  "timestamp": "2019-06-14T12:00:00.000Z",
  "subscriptionId": "3rtt23ryy-56665-t7r7-a0ae-748895yhhf94ujrr",
  "ownerId": "1500723004",
  "body": {
    "records": [
      {
        "member": {
          "id": "411753183004"
        },
        "acceptCurrentQueueCalls": true
      },
      {
        "member": {
          "id": "411753646416541"
        },
        "acceptCurrentQueueCalls": false
      }
    ]
  }
}

Actual SDK model expectation

The current SDK model appears to expect a flat body similar to:

{
  "extensionId": "...",
  "callQueueId": "...",
  "acceptCalls": true
}

However, the actual event body is structured around:

{
  "records": [
    {
      "member": {
        "id": "..."
      },
      "acceptCurrentQueueCalls": true
    }
  ]
}

Expected model

The body should likely be modeled as something similar to:

public class CallQueuePresenceEventBody
{
    public CallQueuePresenceEventRecord[] records { get; set; }
}

public class CallQueuePresenceEventRecord
{
    public CallQueueMemberInfo member { get; set; }

    public bool? acceptCurrentQueueCalls { get; set; }
}

public class CallQueueMemberInfo
{
    public string id { get; set; }
}

Relevant links:

• Current SDK file: https://github.com/ringcentral/RingCentral.Net/blob/master/RingCentral.Net/Definitions/CallQueuePresenceEventBody.cs
• API documentation: https://developers.ringcentral.com/api-reference/Call-Queue-Member-Presence-Event

[tylerlong]

Thanks for reporting this. The SDK is auto generated base on OpenAI spec. So I believe it is a spec issue. I will raise a ticket for the internal spec team.

[mtherriault]

In fact, the actual payload we receive is different from what the documentation mentions. I already opened a ticket (30678148) and received a response (3/5/2026) stating that the documentation was out of date.

"This is a documentation bug; we will fix it in our documentation. The payload you received is correct."

This isn't the first discrepancy I've noticed.