Crop Library
Add to shortlist
Add an admin-catalog crop to the user’s personal shortlist.
POST
Authentication
Requires a key with thelibrary:write scope.
Request body
UUID of the admin crop to add. Must reference a verified, active admin crop.
Optional farm UUID — bind the shortlist entry to a specific farm.
One of
manual_search, ai_recommendation.User overrides (free-form JSON; common keys:
customName, customNotes, customGrowthDuration).Response
Returns the created shortlist entry wrapped underdata. See List shortlist for the field reference.
Errors
| Status | When |
|---|---|
400 VALIDATION_ERROR | Body validation failed |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks library:write scope |
404 NOT_FOUND | Admin crop doesn’t exist or is inactive |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |