social.colibri.beta.bridge.importMessages
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.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | bridge.beta.colibri.social |
| Indexed |
Procedure
procedure · POSTInput
application/jsonThe linked channel, or a thread beside it, the messages go into.
The community the registration belongs to.
The messages, oldest first.
minLength: 1maxLength: 25
A message.
Record key of the registration.
Output
application/jsonOne result per message, in input order.
A written message.
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.
RegistrationDisabled
An admin has paused this registration.
ChannelNotLinked
The channel is not linked to this registration.
RateLimited
The bridge sent too many requests. Retry after the interval in the response headers.
CredentialsUnavailable
The AppView cannot act as the community because its stored credentials are missing or unusable.
BackfillNotRequested
No admin has asked for a history import on this channel.
OutsideBackfillRange
A message was sent before the requested range or after the request.
#importResult
objectWhere an imported message was written.
Properties
The message's id on the other service.
maxLength: 256
Record key of the record the community wrote.
#importedMessage
objectA message from the room's earlier history.
Properties
attachments
arrayFiles attached to the message.
maxLength: 10
A file uploaded earlier with uploadBlob.
Who sent the message.
When the message was sent on the other service.
facets
arrayAnnotations over ranges of the text.
An annotation.
forward
refContent forwarded from another Colibri message.
parent
refThe message this one replies to.
parentUri
string · at-uriThe message this one replies to, as a record URI in the channel. Preferred over `parent` when it is valid.
The message's id on the other service.
maxLength: 256
The message body.
maxLength: 2048
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
social.colibri.beta.bridge.postMessage
procedurePosts a message from someone on another service into a linked channel. The community writes the message, attributed to that person.
-
Reports how far a history import has got, so admins can follow it.
-
Who wrote a record on another service. The community writes every bridged record, and the AppView honours this attribution only on records the community itself wrote.
-
social.colibri.beta.bridge.createThread
procedureOpens a thread beside a linked channel for someone on another service. The community writes the thread, attributed to that person.
-
social.colibri.beta.bridge.editMessage
procedureReplaces the text of a message the calling bridge posted.