latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

LinkMablnet

Get the current mablnet peer-CA trust bundle for this environment

Returns the X.509 root certificate(s) every mablnet client should trust as peer-CA roots when verifying mabl-side Host certs during the peer-to-peer QUIC TLS handshake. Per-environment global: the same bundle for every caller in a deployment. Bundle bytes come from the deployment's published trust bundle — the same anchors Link Router loads on startup. More than one anchor may be present: a root rotation publishes the incoming anchor alongside the outgoing one, and callers should trust every certificate in the bundle. The bundle is non-secret — X.509 root certificates are public artefacts by definition; protection here is integrity, not confidentiality. Auth is required for attribution / rate-limiting / audit, not because the bytes are sensitive. Conditional refetch: callers send their last-known ETag as If-None-Match on each poll. The server returns 304 Not Modified (no body) when the bundle is unchanged. The current ETag is mirrored in both the standard ETag header and the mabl-specific x-mabl-entity-version header (the latter survives upstream gzip-Vary stripping).

get/link/mablnet/peer-ca

Headers

If-None-Matchstring

Last ETag the caller observed; server returns 304 when current ETag matches.

Response

Current bundle returned in body; current ETag in headers.

pemstring required

Concatenated PEM-encoded X.509 trust anchor(s). Multiple BEGIN CERTIFICATE blocks back-to-back when the deployment has more than one root in its CAS pool (e.g. during a CA rotation window when both the outgoing and incoming roots need to be trusted).

operator_public_keystring

Base64-encoded X.509 SubjectPublicKeyInfo of the deployment's operator-token Ed25519 public key. A Host registers the mablnet-operator command service (and verifies per-command operator tokens) against this key. Absent when the deployment has no operator-token signing key configured — in that case the Host runs without the operator interface.