Platform API / Docs

AGRO-AI Platform API private beta

Operational agriculture intelligence through a curated REST API. Access is provisioned per organization, with test and live projects gated separately.

The Platform API is in private beta and disabled by default. Endpoints are enabled per organization by AGRO-AI. Live projects, webhooks, billing, and public docs are each gated behind their own server flags.

Base URL & versioning

All requests are sent to the versioned base path /v1. Platform resources live under /v1/platform.

http

https://api.agroai-pilot.com/v1/platform

The public contract is generated by the API itself. The API reference renders directly from that contract, so it never drifts from the server.

Resource model

The API is resource-oriented. The curated public surface includes:

Resource	Purpose
`providers`	Connect data providers, run syncs, validate credentials.
`fields`, `sources`	Register fields and the sources that feed them.
`observations`	Ingest and query observations.
`recommendations`	Request advisory, model-backed recommendations.
`reports`, `jobs`	Generate reports; track asynchronous work.
`usage`, `request-logs`	Read metered usage and request history.

Recommendations and actions are advisory. The API does not actuate physical irrigation, and provider physical writes are disabled during the beta.

Conventions

JSON request and response bodies; UTF-8; snake_case fields.
Lists use cursor pagination (has_more, items, next_cursor).
Writes accept an Idempotency-Key; every response carries an X-Request-Id.
Errors share one typed shape.