Skip to main content
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" }
  }'

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

POST https://www.wiseyield.co/api/v1/crop-library/user-crops

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.
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

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