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 
{
  "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.",
  "errors": [
    {
      "description": "Missing or invalid service-auth JWT.",
      "name": "AuthRequired"
    },
    {
      "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": "Forbidden"
    },
    {
      "description": "A parameter or body field was missing or malformed.",
      "name": "InvalidRequest"
    },
    {
      "description": "Humming is disabled on this AppView.",
      "name": "NotEnabled"
    },
    {
      "description": "The peer exceeded its per-peer sendHum rate budget.",
      "name": "RateLimited"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "ref": "lex:social.colibri.sync.subscribeEvents#humEnvelope",
      "type": "ref"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@