Sign in
Datasets

Upload File

Upload a geospatial file for staging.

Validates the file extension, creates an ingest job, and saves the file to staging. Does NOT auto-queue ingestion -- use preview then commit.

post/ingest/upload

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

Response

Successful Response

job_idstring uuid required

Unique identifier for the ingestion job. Use this to poll status and to commit the upload.

statusstring

Initial job status. 'pending' means the file is staged and ready to preview; 'running' means the server is still fetching it, as it is for a URL import.

messagestring required

Human-readable message describing the upload result.

Changes

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