Skip to main content

Local Development & CLI

Using the REST API Directly​

Test your geofences and workflows using cURL or any HTTP client:

# Create a geofence
curl -X POST https://api.spatialflow.io/api/v1/geofences \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Test Zone", "geometry": {...}}'

See the Authentication guide for details on API keys and JWT tokens.

Route Tester​

The SpatialFlow dashboard includes a built-in Route Tester for validating routes:

  • Upload GPX or CSV files to analyze device routes
  • Preview which geofences a route crosses
  • See which workflows would trigger based on geofence events

OpenAPI Specification​

Generate your own client in any language using the OpenAPI spec:

curl https://api.spatialflow.io/api/v1/openapi.json

Import the spec into tools like Postman, Insomnia, or use code generators like openapi-generator to create typed clients for your language of choice.