social.colibri.sync.sendHum

colibri.social

Documentation

Informs this AppView of an off-protocol event that occurred on a peer AppView. Requires inter-service auth: a JWT signed by the caller's AppView signing key, aud = this AppView's did:web, lxm = social.colibri.sync.sendHum. The receiver drops the Hum unless the JWT issuer equals both the envelope `origin` and the `subject`'s declared presenceService.

main procedure

Informs this AppView of an off-protocol event that occurred on a peer AppView. Requires inter-service auth: a JWT signed by the caller's AppView signing key, aud = this AppView's did:web, lxm = social.colibri.sync.sendHum. The receiver drops the Hum unless the JWT issuer equals both the envelope `origin` and the `subject`'s declared presenceService.

Input

Encodingapplication/json
Schemalex:social.colibri.sync.subscribeEvents#humEnvelope

Errors

AuthRequired Missing or invalid service-auth JWT.
Forbidden A trust-model check failed (origin is not the subject's declared presenceService, subject is not a community member, origin is not an AppView, or a channel does not belong to the community).
InvalidRequest A parameter or body field was missing or malformed.
NotEnabled Humming is disabled on this AppView.
RateLimited The peer exceeded its per-peer sendHum rate budget.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "ref": "lex:social.colibri.sync.subscribeEvents#humEnvelope",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthRequired",
      "description": "Missing or invalid service-auth JWT."
    },
    {
      "name": "Forbidden",
      "description": "A trust-model check failed (origin is not the subject's declared presenceService, subject is not a community member, origin is not an AppView, or a channel does not belong to the community)."
    },
    {
      "name": "InvalidRequest",
      "description": "A parameter or body field was missing or malformed."
    },
    {
      "name": "NotEnabled",
      "description": "Humming is disabled on this AppView."
    },
    {
      "name": "RateLimited",
      "description": "The peer exceeded its per-peer sendHum rate budget."
    }
  ],
  "description": "Informs this AppView of an off-protocol event that occurred on a peer AppView. Requires inter-service auth: a JWT signed by the caller's AppView signing key, aud = this AppView's did:web, lxm = social.colibri.sync.sendHum. The receiver drops the Hum unless the JWT issuer equals both the envelope `origin` and the `subject`'s declared presenceService."
}

Lexicon Garden

@