Sign in
Datasets

Commit Fan Out

Convert a single pending IngestJob into N independent per-layer ingest tasks.

For multi-layer sources (e.g. GeoPackage with 2+ layers), this endpoint fans out the original upload into one Procrastinate task per requested layer, each becoming a separate dataset. The original job is marked 'fanned_out' (a terminal state).

Required: original job must be in status='pending'. Each layer_name in the request body must appear in job.user_metadata['all_layers']. Unknown layer names return HTTP 422 with the list of unrecognized names.

Returns HTTP 202 with per-layer outcomes. Partial success is possible: each layer result carries status='queued' or status='failed' with a user-safe error message.

Permission: same as POST /ingest/commit/{job_id} — 'upload' capability.

post/ingest/commit-fan-out/{job_id}

Request

  • The document declares no server URL.
  • Auth: one of:
    • OAuth 2 (password, token URL /api/auth/login)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Path parameters

job_idstring uuid required

Request body

Response

Successful Response

fan_out_idstring uuid required

The original job_id (parent). Use for client-side correlation.

Changes

No recorded changes to this operation across all 50 revisions of this API.