app.bivri.feed.createArtwork

Publish a new artwork to the authenticated member's repository. Requires an OAuth session; the record is written to the member's own PDS.

Details · procedure
Kindprocedure
Authorityfeed.bivri.app
Indexed

Procedure

procedure · POST

Input

application/json

Free-form description of the artwork.

  • maxLength: 3000
  • maxGraphemes: 300

labels

union

Self-label values the author declares on this artwork, such as a spoiler warning. These are author metadata, not platform moderation decisions.

langs

array

Human languages of the artwork's title and description.

  • maxLength: 3
itemsstring · language

media

requiredarray

Images making up the artwork, in display order. At least one is required. Blobs are uploaded beforehand through com.atproto.repo.uploadBlob, and the items together may not exceed 200MB — a total this schema cannot express.

  • minLength: 1
  • maxLength: 50

tags

array

Author-chosen tags used for discovery and search.

  • maxLength: 8
itemsstring
  • minLength: 1
  • maxLength: 640
  • maxGraphemes: 64

title

requiredstring

Title of the artwork. An artwork cannot be published without one.

  • minLength: 1
  • maxLength: 500
  • maxGraphemes: 50

Output

application/json

cid

requiredstring · cid

CID of the artwork record that was written.

uri

requiredstring · at-uri

AT URI of the artwork record that was written.

Errors

ConsentRequired

The authenticated member has not confirmed age and accepted the Terms and Privacy Policy.

Similar lexicons

semantic match

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

  • Publish a new artwork to the authenticated member's repository. Requires an OAuth session; the record is written to the member's own PDS.

  • Record containing a Bivri artwork: one or more images published together under a single title.

  • Edit an artwork the authenticated member owns. Only the fields present in the request change; the rest of the record is preserved as it stands at the member's PDS.

  • Edit an artwork the authenticated member owns. Only the fields present in the request change; the rest of the record is preserved as it stands at the member's PDS.

  • Artwork record supporting JPEG, PNG, GIF and WebP originals. Earlier app.bivri.feed.artwork records retain their original schema and identity.