Lexicon Garden

social.colibri.beta.community.putImage

Sets a community's picture or banner. The bytes are uploaded to the community's own repo, which is why this goes through the AppView: a community's blobs can only be written with the community credentials the AppView holds, and a space record must reference a blob living in the repo that holds the record. Replaces whatever was there before.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritycommunity.beta.colibri.social
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Parameters

query string

community

requiredstring · did

The community to set the image on.

kind

requiredstring

Which image to set.

  • knownValues: picture | banner

Input

image/*

Output

application/json

community

requiredref

The community with the new image resolved, so one call is enough to re-render.

Reference

Errors

AuthRequired

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

Forbidden

The requesting user lacks the community.manage permission.

CommunityNotFound

No community exists with that DID.

UnsupportedImage

The bytes are not one of the accepted image types.

ImageTooLarge

The image exceeds the size limit for this kind.

CredentialsUnavailable

The AppView's stored credentials for this community are missing or unusable.

UpstreamFailure

A PDS or third-party call the AppView depends on failed.

Similar lexicons

semantic match

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

  • social.colibri.beta.community.deleteImage

    procedure

    Clears a community's picture or banner. Idempotent: clearing an image that was never set succeeds. The blob itself is left in the community's repo rather than deleted, so an older record revision still resolves.

  • social.colibri.beta.role.putBadgeImage

    procedure

    Sets a role's badge to an uploaded image. The bytes are uploaded to the community's own repo, which is why this goes through the AppView: a space record must reference a blob living in the repo that holds the record. Replaces whatever badge was there before. Use social.colibri.beta.role.update with removeBadge to clear it.

  • social.colibri.community.update

    procedure not from the namespace authority

    Updates a community's metadata and optionally its picture and banner.

  • social.coves.community.update

    procedure

    Update community profile. Requires authentication and moderator/admin permissions.

  • social.colibri.beta.bridge.uploadBlob

    procedure

    Uploads a file to the community's repo for use in a bridged message or as a bridged author's avatar.