social.colibri.beta.polyfill.uploadBlob

Stores a blob for the requesting user while the AppView hosts their space repos. A blob nothing references within a day is deleted.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritypolyfill.beta.colibri.social
Commit rev3n2beo35vmd22
Indexed

Procedure

procedure · POST

Input

*/*

Output

application/json

blob

requiredblob

A reference to the stored blob, for use in a record.

Errors

AuthRequired

The request has no valid service auth.

InvalidRequest

The arguments are inconsistent or malformed beyond schema validation.

RepoNotHosted

The AppView does not host the caller's repos. Upload to the PDS instead.

BlobTooLarge

The blob exceeds the size limit.

BlobStorageUnavailable

The AppView has no blob storage configured, so it cannot hold attachments right now.

Similar lexicons

semantic match

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

  • Upload a new blob, to be referenced from a repository record. The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created. Requires auth, implemented by PDS.

  • Upload a new blob, to be referenced from a Stratos repository record. The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created. Requires auth, implemented by Stratos service.

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

  • Returns the bytes of a blob the requesting user stored with the AppView, so a migration can upload it to their PDS.

  • 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.