social.colibri.beta.community.putImage
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "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.",
"errors": [
{
"description": "The request is missing, malformed, or unverifiable service auth.",
"name": "AuthRequired"
},
{
"description": "The requesting user lacks the community.manage permission.",
"name": "Forbidden"
},
{
"description": "No community exists with that DID.",
"name": "CommunityNotFound"
},
{
"description": "The bytes are not one of the accepted image types.",
"name": "UnsupportedImage"
},
{
"description": "The image exceeds the size limit for this kind.",
"name": "ImageTooLarge"
},
{
"description": "The AppView's stored credentials for this community are missing or unusable.",
"name": "CredentialsUnavailable"
},
{
"description": "A PDS or third-party call the AppView depends on failed.",
"name": "UpstreamFailure"
}
],
"input": {
"description": "The raw image bytes. The content type must be one of image/jpeg, image/png, image/gif or image/webp, and is sniffed rather than trusted.",
"encoding": "image/*"
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"community": {
"description": "The community with the new image resolved, so one call is enough to re-render.",
"ref": "social.colibri.beta.community.defs#communityView",
"type": "ref"
}
},
"required": [
"community"
],
"type": "object"
}
},
"parameters": {
"properties": {
"community": {
"description": "The community to set the image on.",
"format": "did",
"type": "string"
},
"kind": {
"description": "Which image to set.",
"knownValues": [
"picture",
"banner"
],
"type": "string"
}
},
"required": [
"community",
"kind"
],
"type": "params"
},
"type": "procedure"
}
},
"id": "social.colibri.beta.community.putImage",
"lexicon": 1
}
Metadata
- DID
-
did:plc:mprdjqjluoswa7awzggaggj3 - CID
-
bafyreigs6jhehjowchhapa7u3scfcogp4naaf2yksy3vkmoj3y47lc6mgi - Indexed At
- 2026-08-23 13:08 UTC
- AT-URI
-
at://did:plc:mprdjqjluoswa7awzggaggj3/com.atproto.lexicon.schema/social.colibri.beta.community.putImage
Referenced Schemas (1)
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
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.
-
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.
-
fyi.opensocial.uploadImage procedure
Upload an image for the profile avatar or banner. Requires group.configure. Binary input like com.atproto.repo.uploadBlob; the group is a parameter because the blob has to land in that group's repo for a profile record …