Errors

HTTP status codes

Status	Meaning
200	Success
201	Job created
400	Validation error — see response body
401	Missing or invalid auth token
404	Resource not found
500	Internal server error

Error response format

{
  "error": "descriptive message"
}

Common 400 errors

Missing required input artifact:

{ "error": "Missing required input artifact: job:input_las" }

You provided a recipe that requires job:input_las but the inputs map doesn't include it.

Unknown executor type:

{ "error": "Unknown executor type: MY_STEP" }

The type field in a recipe step doesn't match any registered executor.

Input slot mismatch:

{ "error": "Step 'build_copc': unexpected input slot 'wrong_slot'" }

The slot names in a step's inputs don't exactly match what the executor declares in accepts.

Missing required param:

{ "error": "Step 'reproject': missing required param 'source_epsg'" }

A step declares param_keys: ["source_epsg"] but the job's params object doesn't include it.

Duplicate step ID:

{ "error": "Duplicate step ID: build_copc" }

Two steps in the same recipe share the same id.

Cycle detected:

{ "error": "Recipe contains a cycle" }

The artifact flow creates a circular dependency between steps.

Invalid output reference:

{ "error": "Output 'step:unknown.output_las' is not producible by this recipe" }

The outputs field references an artifact that no step in the recipe produces.