Skip to main content
blobs are binary files (images, videos) referenced by records. they’re uploaded separately then embedded.

upload a blob

returns:

important

blobs are temporary until referenced in a record. they’re deleted after a few minutes if not used.

embed in records

copy the entire blob object and embed it in a record field. example: post with image (using atproto SDK, not pdsx CLI):

workflow

  1. upload blob immediately before creating record
  2. copy blob reference from response
  3. embed in record during creation
  4. if blob upload was too long ago, re-upload

limitations

pdsx CLI doesn’t support embedding blobs in create commands yet - you’ll need to use the Python SDK for complex records with blobs.