social.colibri.beta.bridge.redeemPairing

Connects a bridge to a community by redeeming its pairing code. Writes a registration with no linked channels.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority

Details · procedure

Compare Edit in builder → Fork →

Procedure

procedure · POST

application/json

requiredstring

The pairing code.

requiredstring · did

The community to connect the bridge to.

application/json

requiredref

The registration.

Reference

The request is missing, malformed, or unverifiable service auth.

The caller lacks the community.manage permission.

No community exists at the given DID.

The code does not exist, has expired, or was already used.

This bridge is already connected to the same remote space in this community.

The AppView cannot act as the community because its stored credentials are missing or unusable.

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

social.colibri.beta.bridge.createPairing
procedure

Starts pairing a bridge with a community. Called by the bridge, which shows the returned code to an admin on the other service. A Colibri admin then redeems the code, which proves both sides agreed.
social.colibri.beta.bridge.getPairing
query

Describes a pending pairing code so an admin can see which bridge they are about to connect.
social.colibri.beta.bridge.revoke
procedure

Disconnects a bridge from a community and deletes its registration. Messages it already relayed stay.
social.colibri.beta.bridge.leave
procedure

Disconnects the calling bridge from a community and deletes its registration, for when the remote space removed the bridge. Messages it already relayed stay.
social.colibri.beta.bridge.listRegistrations
query

Lists the bridges connected to a community.