Lexicon Garden

dev.knotless.uploadImage

Uploads the body, a PNG, JPEG, WebP or GIF, as a blob of the account logged in to this appview's web pages, as `knotless issue --image` does: one over 1,000,000 bytes is drawn again as a JPEG that fits, at most 2000 pixels on its longest side. Its PDS keeps it only once a record attaches it: give it as one of dev.knotless.createIssue's, createPull's, createComment's or editItem's `images`, with a body linking to `url`. Requires the session cookie the pages' login sets.

Repository @lexicons.knotless.dev did:plc:yqsg7znbbhfmj3a2nrpnaerk namespace authority
Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed

Showing version bafyreifkusx4zq7yswabgcqih7zswoxkssz5kt2x4r6rops56yoqkfcxui. Show the latest

Compare Edit in builder → Fork →

Procedure

procedure · POST

Parameters

query string

repo

requiredstring · at-uri

The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it, whose pull, issue or comment will show it.

Input

*/*

Output

application/json

blob

requiredblob

The picture as uploaded, to attach.

  • maxSize: 1000000
  • accept: image/png, image/jpeg, image/webp, image/gif

height

integer

How high it is drawn, in CSS pixels.

  • minimum: 1

url

requiredstring · uri

Where its account's PDS serves it, for the body to link to.

width

integer

How wide it is drawn, in CSS pixels, as dev.knotless.defs#image's `width`: its pixels over the density a PNG says it was made at. Give it, and `height`, with the blob in `images`.

  • minimum: 1

Errors

NotFound

No such repository.

InvalidRequest

No picture, or one that is not a PNG, JPEG, WebP or GIF.

AuthenticationRequired

No account is logged in to the pages, or its session has ended.

Similar lexicons

semantic match

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

  • dev.knotless.uploadAvatar

    procedure

    Sets the picture of the account logged in to this appview's pages.

  • app.didpic.write.uploadBlob

    procedure

    Upload raw image bytes to the authenticated viewer's own PDS, mediated by the AppView using its server-held session (confidential OAuth client only). Mirrors com.atproto.repo.uploadBlob. The returned blob ref is passed into createPost, createComment, or putProfile to attach it to a record. This endpoint applies no per-context size limit beyond a generous ceiling — the PDS enforces the real limit (post/comment 5MB, avatar 1MB, banner 2MB) when the blob is actually attached to a record.

  • dev.knotless.getAttachment

    query

    Something a pull, an issue or a comment attaches, such as a picture its body shows.

  • dev.knotless.createIssue

    procedure

    Opens an issue on a repository, as the account logged in to this appview's pages.