Lexicon Garden

social.colibri.beta.emoji.upload

Adds a custom emoji to a community. The bytes are uploaded to the community's own repo and the AppView writes the provider's record there with the community's credentials.

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

Procedure

procedure · POST

Parameters

query string

community

requiredstring · did

The community that owns the emoji.

name

requiredstring

The emoji's name without colons. Lowercase letters, digits and underscores.

  • minLength: 2
  • maxLength: 32

pack

string · at-uri

A pack of the community to add the emoji to.

provider

string

The emoji provider that writes the records. Defaults to the AppView's default provider.

  • knownValues: blue.moji

Input

image/*

Output

application/json

emoji

requiredref

The emoji as stored.

Reference

Errors

AuthRequired

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

Forbidden

The caller lacks the community.manage permission.

CommunityNotFound

No community exists at the given DID.

InvalidName

The name is not 2 to 32 characters of lowercase letters, digits and underscores.

NameTaken

The community already has an emoji with this name.

PackNotFound

No pack of this community exists at the given URI.

UnsupportedProvider

The emoji provider is unknown, or it does not support the requested operation.

UnsupportedImage

The bytes are not an image type the provider accepts.

ImageTooLarge

The image exceeds the provider's size limit.

CredentialsUnavailable

The AppView cannot act as the community because its stored credentials are missing or unusable.

UpstreamFailure

A PDS 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.emoji.createPack

    procedure not from the namespace authority

    Creates a pack of a community's custom emoji.

  • social.colibri.beta.emoji.rename

    procedure not from the namespace authority

    Renames a community's custom emoji. Providers that key records by name move the record to a new key and repoint pack memberships, so the emoji's URI changes.

  • social.colibri.beta.emoji.updatePack

    procedure not from the namespace authority

    Renames a community's pack or replaces its emoji. Omitted fields stay as they are.

  • social.colibri.beta.emoji.delete

    procedure not from the namespace authority

    Deletes a community's custom emoji and removes it from every pack of the community. Copies other people made stay in their repos.

  • social.colibri.beta.community.putImage

    procedure

    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.