Skip to main content

​
Ingest External Image

Accept an image from an external source and store it in Pindeck. Primarily used by the Discord bot to ingest images from Discord channels.

​
How it works

  1. An external service (e.g., Discord bot) sends an image URL and metadata
  2. Pindeck downloads the image and stores it in Convex file storage
  3. A background action persists the file to Nextcloud via WebDAV
  4. An image record is created with the specified sourceType

​
Source types

SourceDescription
discordIngested from a Discord channel via emoji trigger
pinterestImported from a Pinterest board
uploadStandard user upload (rarely used via this endpoint)
aiAI-generated image (rarely used via this endpoint)

​
Deduplication

Provide an externalId to prevent duplicate ingest. If an image with the same externalId already exists, the request will be rejected with a 400 error.