CodeB Conference Status ← Back to app
Public API

/diag.ashx · public API

Append-only diagnostic log endpoint used by the conference client. Captures per-call WebRTC observability data (ICE candidates, transition timelines, RTP byte counters) so operators can later reconstruct why a particular session failed.

The POST is public; the GET tail is not. Anyone can append; only admins (HMAC-signed) can read entries back. Entries are persisted server-side and are readable only by an authenticated admin.

POST /diag.ashx #

Append client-side diagnostic entries. Used by the conference page’s WebRTC instrumentation to record ICE candidates, connection-state transitions and RTP byte counters. Entries are buffered server-side for the admin diagnostic UI.

Request

application/json body:

{
  "entries": [
    { "t": "2026-06-02T19:33:37.388Z",
      "s": "<session-id>",
      "u": "<user-context>",
      "m": "ice-conn state=connected" }
  ]
}

Up to 100 entries per POST.

Response

{ "appended": N } where N is the count actually stored.

Errors

Malformed JSON is silently dropped (returns {appended:0}) so a buggy logger never breaks the page. 500 is the only error you might see, from disk I/O.

The GET tail of this endpoint is admin-gated via the X-CodeB-Admin-Signature HMAC header and is therefore not part of the public API.
Need an admin endpoint? Admin-only and OIDC Bearer-gated routes are documented inside the admin UI itself (visible only to signed-in admins on this host). The public API set on this page is the surface you can integrate against without provisioning a CodeB user.

Questions? Ask us · Index: All public APIs