Skip to main content
POST

Authentication

Requires a key with the library:write scope.

Request body

adminCropId
string
required
UUID of the admin crop to add. Must reference a verified, active admin crop.
farmId
string
Optional farm UUID — bind the shortlist entry to a specific farm.
source
string
default:"manual_search"
One of manual_search, ai_recommendation.
customizations
object
User overrides (free-form JSON; common keys: customName, customNotes, customGrowthDuration).

Response

Returns the created shortlist entry wrapped under data. See List shortlist for the field reference.

Errors

StatusWhen
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks library:write scope
404 NOT_FOUNDAdmin crop doesn’t exist or is inactive
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error