curl -X POST 'https://www.wiseyield.co/api/v1/crop-library/user-crops' \
-H "Authorization: Bearer $WISEYIELD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"adminCropId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"source": "manual_search",
"customizations": { "customNotes": "Considering for north field next season" }
}'
Crop Library
Add to shortlist
Add an admin-catalog crop to the user’s personal shortlist.
POST
/
api
/
v1
/
crop-library
/
user-crops
curl -X POST 'https://www.wiseyield.co/api/v1/crop-library/user-crops' \
-H "Authorization: Bearer $WISEYIELD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"adminCropId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"source": "manual_search",
"customizations": { "customNotes": "Considering for north field next season" }
}'
POST https://www.wiseyield.co/api/v1/crop-library/user-crops
Authentication
Requires a key with thelibrary:write scope.
Request body
string
required
UUID of the admin crop to add. Must reference a verified, active admin crop.
string
Optional farm UUID — bind the shortlist entry to a specific farm.
string
default:"manual_search"
One of
manual_search, ai_recommendation.object
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.
curl -X POST 'https://www.wiseyield.co/api/v1/crop-library/user-crops' \
-H "Authorization: Bearer $WISEYIELD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"adminCropId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"source": "manual_search",
"customizations": { "customNotes": "Considering for north field next season" }
}'
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 |