Skip to main content
POST

Authentication

Requires a key with the fields:write scope.

Path parameters

id
string
required
Farm UUID.
fieldId
string
required
Field UUID.
blockId
string
required
Block UUID.

Request body

label
string
required
1–100 characters. Within-block identifier (e.g. "Row 1, Tree 4", "P-0001").
tagId
string
1–200 characters. QR / RFID / barcode identifier. Unique within the block — duplicate returns 409 CONFLICT.
position
object
{ lat: number, lng: number }. GPS position. Pass null to clear.
plantedAt
string
ISO 8601 datetime.
status
string
default:"alive"
One of alive, sick, dead, replaced, removed.
notes
string
Up to 2,000 characters.

Response

Returns the created plant wrapped under data.

Errors

StatusWhen
400 INVALID_IDAny path UUID is malformed
400 VALIDATION_ERRORBody validation failed
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:write scope
404 NOT_FOUNDFarm, field, or block doesn’t exist or belongs to another user
409 CONFLICTtagId already exists for another plant in this block
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error