Back to API overview
Missions

Submit a mission

POST/v1/missions Bearer API key

Kick off a recurring, agent-driven monitoring and prediction mission over a region.

A mission is the highest-level unit of work. Provide a region, an objective in plain language, a monitoring cadence, and the deliverables you want. The recursive agent network handles imagery selection, analysis, prediction, and delivery, with human-governed approval before consequential outputs.

Request body

region_idrequiredstring

The region the mission monitors.

objectiverequiredstring

Plain-language description of what to monitor and predict.

cadencerequiredstring

Monitoring frequency: daily, weekly, or monthly.

deliverablesoptionalstring[]

Outputs to produce, e.g. executive_report, alerts, api_risk_scores.

Response fields

idoptionalstring

Mission identifier.

statusoptionalstring

Lifecycle status: queued, active, or paused.

next_runoptionaltimestamp

When the next monitoring cycle is scheduled.

curl -X POST https://api.satellitex.ai/v1/missions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "region_id": "reg_central_valley",
    "objective": "Monitor crop stress and predict drought exposure over 45 days",
    "cadence": "weekly",
    "deliverables": ["executive_report", "alerts", "api_risk_scores"]
  }'

Illustrative API — keys and identifiers are for demonstration.

Related endpoints

Ready to build with this?

Request access and we'll help you scope your first mission and provision API keys.

Request API access