# Weather, earth observation, and field notes

> Reference the normalized read and write endpoints attached to a field.

Human-readable version: https://agsemble.com/docs/api/data

## Field data reads

```http
GET /api/v1/weather?field_id=fld_...
GET /api/v1/earth-observations?field_id=fld_...
GET /api/v1/observations?field_id=fld_...&limit=100
```

## Field observation writes

```http
POST /api/v1/observations
Authorization: Bearer ag_test_...
Content-Type: application/json
Idempotency-Key: obs_device_123
```

## Complete schemas

Use the OpenAPI 3.1 document for generated types, every request property, response schema, unit enum, and structured error.

- OpenAPI: https://api.agsemble.com/openapi.json
- SDK release: https://api.agsemble.com/sdk.json
