v1.3.0
Summary
Launch of the public API documentation via Scalar. Over 100 endpoints are now documented and accessible through the API docs portal, covering boundaries, fields, farms, growers, companies, equipment, guidance, routing, path plans, exports, and sharing.
New Features
1. Public API Documentation Launch
The LaunchPad API is now fully documented via Scalar at `/docs`. All major resource endpoints are exposed with comprehensive documentation including request/response schemas, parameter descriptions, and workflow guidance.
2. Boundary Management
Full CRUD operations for field boundaries with multiple export formats.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/boundaries/{boundaryId} |
Get boundary details |
| GET | /api/boundaries/{boundaryId}/geojson |
Export boundary as GeoJSON |
| GET | /api/boundaries/{boundaryId}/wkt |
Export boundary as WKT |
| GET | /api/boundaries/{boundaryId}/kml |
Export boundary as KML |
| GET | /api/boundaries/{boundaryId}/path-plan-ids |
Get path plan IDs for boundary |
| GET | /api/boundaries/{boundaryId}/reference-lines |
Get reference lines |
| POST | /api/boundaries/{boundaryId}/activate |
Activate a boundary |
| POST | /api/vBoundary/upsert |
Create or update boundary |
3. Company, Grower, Farm & Field Management
Complete hierarchy management from company down to field level.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/companies/{companyId} |
Get company details |
| GET | /api/companies/{companyId}/growers |
List growers |
| GET | /api/companies/{companyId}/farms |
List farms |
| GET | /api/companies/{companyId}/equipment |
List equipment |
| GET | /api/companies/{companyId}/fields-with-boundaries |
List fields with boundaries |
| GET | /api/growers/{growerId}/farms |
List grower farms |
| GET | /api/fields/{fieldId} |
Get field details |
| GET | /api/fields/{fieldId}/boundaries |
Get field boundaries |
| POST | /api/fields/save |
Save field |
| POST | /api/fields/field-with-boundaries |
Create field with boundaries |
4. Path Plan Generation & Management
Generate, retrieve, and manage path plans via the API.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/path-plans/direct |
Generate path plan directly |
| POST | /api/path-plans/direct/geojson |
Generate path plan with GeoJSON response |
| GET | /api/path-plans/{pathPlanId} |
Get path plan details |
| PUT | /api/path-plans/{pathPlanId}/name |
Update path plan name |
| POST | /api/path-plans/archive |
Archive path plans |
| POST | /api/path-plans/csv |
Export path plans as CSV |
| POST | /api/path-plans/seasonal-summary-result |
Get seasonal summary |
5. Routing
Generate and manage optimized routes for path plans.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/routes |
Generate route |
| GET | /api/routes/jobs/{jobId} |
Get routing job status |
| GET | /api/routes/{routeId} |
Get route details |
| GET | /api/routes/{routeId}/gpx |
Export route as GPX |
| POST | /api/routes/construct |
Construct route from parameters |
6. Bulk Guidance Generation
Generate guidance for multiple field boundaries in a single asynchronous operation.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/bulk-guidance |
Start bulk guidance generation |
| GET | /api/bulk-guidance/jobs/{jobId} |
Poll bulk guidance job status |
7. Equipment Scenarios
Compare different equipment configurations across fields.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/equipment-scenarios |
Create equipment scenario |
| GET | /api/equipment-scenarios/{equipmentScenarioId} |
Get scenario details |
| GET | /api/equipment-scenarios/jobs/{jobId} |
Get scenario job status |
| POST | /api/equipment-scenarios/fields-summary |
Get fields summary |
8. Path Plan Exports
Export path plans in various formats for use with farm equipment terminals.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/path-plans-export |
Start export job (ISO-XML, Shapefile, KML, etc.) |
| GET | /api/path-plans-export/jobs/{jobId} |
Get export job status |
| GET | /api/path-plans-export/{batchId}/file |
Download exported file |
9. Reference Lines
Generate default reference lines, contours, and straight edges for field boundaries.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/reference-lines/default-lines |
Generate default reference lines |
| POST | /api/reference-lines/default-contours |
Generate contour lines |
| POST | /api/reference-lines/default-straight-edges |
Generate straight edges |
| POST | /api/reference-lines/default-reference-lines |
Generate all reference line types |
10. Geometry Operations
Utility endpoints for geometry processing.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/geometry/smooth-line |
Smooth a single line geometry |
| POST | /api/geometry/smooth-lines |
Smooth multiple line geometries |
11. Wheel Traffic Analysis
Calculate and visualize wheel traffic patterns on fields.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/wheel-traffic-summary |
Calculate wheel traffic summary |
| POST | /api/wheel-traffic-summary/{pathPlanId} |
Get path plan wheel traffic |
| POST | /api/wheel-traffic-summary/{pathPlanId}/geojson |
Get wheel traffic as GeoJSON |
12. User & File Management
Manage user information and uploaded files.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/user/current |
Get current user details |
| POST | /api/companies/{companyId}/user-files/file-upload |
Upload user file |
| GET | /api/companies/{companyId}/user-files |
List user files |
13. External Integrations Sync
Trigger synchronization with external agriculture platforms.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/external/companies/sync |
Sync company data from external providers |
Questions?
For questions about these API changes, please contact [email protected] or refer to the API documentation.