Back to API overview
Analysis

Run an analysis job

POST/v1/analysis/jobs Bearer API key

Run a one-off analysis over specific scenes without committing to a recurring mission.

Analysis jobs apply a named model or workflow to a set of scenes and return structured results. Use them for ad-hoc investigations, backfills, or to validate an approach before promoting it into a recurring mission.

Request body

scene_idsrequiredstring[]

Scenes to analyze, from an imagery search.

workflowrequiredstring

Named analysis workflow, e.g. crop_stress_v2.

region_idoptionalstring

Optional region context for the job.

Response fields

idoptionalstring

Analysis job identifier.

statusoptionalstring

Job status: queued, running, or complete.

result_urloptionalstring

Where structured results are delivered when complete.

curl -X POST https://api.satellitex.ai/v1/analysis/jobs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "scene_ids": ["scn_9a12", "scn_9a55"],
    "workflow": "crop_stress_v2",
    "region_id": "reg_central_valley"
  }'

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