social.colibri.beta.bridge.reportBackfill

Reports how far a history import has got, so admins can follow it.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritybridge.beta.colibri.social
Indexed

Procedure

procedure · POST

Input

application/json

channel

requiredstring · space-ref

The linked channel being filled.

community

requiredstring · did

The community the registration belongs to.

from

requiredstring · datetime

The start of the time range being imported.

imported

requiredinteger

How many messages the bridge has imported so far.

  • minimum: 0

reached

string · datetime

When the newest imported message in the channel was sent.

registration

requiredstring · tid

Record key of the registration.

requestedAt

requiredstring · datetime

The request the report belongs to, as it appears on the link.

state

requiredstring

How far the import is.

  • knownValues: running | done | failed

until

requiredstring · datetime

The end of the time range being imported.

Output

application/json

Errors

AuthRequired

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

CommunityNotFound

No community exists at the given DID.

RegistrationNotFound

The community has no bridge registration with that id.

Forbidden

The caller is not the bridge this registration belongs to.

ChannelNotLinked

The channel is not linked to this registration.

RateLimited

The bridge sent too many requests. Retry after the interval in the response headers.

BackfillNotRequested

No admin has asked for a history import on this channel.

Similar lexicons

semantic match

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

  • Imports earlier messages from someone on another service into a linked channel or a thread beside it, after an admin asked for a history import. The community writes each message at its original time, and clients see them only when they load history.