Plants
Create plant
Create a per-plant record under a block. Tag IDs are unique within a block.
POST
Authentication
Requires a key with thefields:write scope.
Path parameters
Farm UUID.
Field UUID.
Block UUID.
Request body
1–100 characters. Within-block identifier (e.g.
"Row 1, Tree 4", "P-0001").1–200 characters. QR / RFID / barcode identifier. Unique within the block — duplicate returns
409 CONFLICT.{ lat: number, lng: number }. GPS position. Pass null to clear.ISO 8601 datetime.
One of
alive, sick, dead, replaced, removed.Up to 2,000 characters.
Response
Returns the created plant wrapped underdata.
Errors
| Status | When |
|---|---|
400 INVALID_ID | Any path UUID is malformed |
400 VALIDATION_ERROR | Body validation failed |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:write scope |
404 NOT_FOUND | Farm, field, or block doesn’t exist or belongs to another user |
409 CONFLICT | tagId already exists for another plant in this block |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |