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

An external service (e.g., Discord bot) sends an image URL and metadata
Pindeck downloads the image and stores it in Convex file storage
A background action persists the file to RustFS through the media API
An image record is created with the specified sourceType

Source types

Source	Description
`discord`	Ingested from a Discord channel via emoji trigger
`pinterest`	Imported from a Pinterest board
`upload`	Standard user upload (rarely used via this endpoint)
`ai`	AI-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.