Upload File
const url = 'https://example.com/ingest/upload';const form = new FormData();form.append('file', 'example');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/ingest/upload \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form file=exampleUpload 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.
Authorizations
Section titled “ Authorizations ”Request Body required
Section titled “ Request Body required ”object
Responses
Section titled “ Responses ”Successful Response
object
Unique identifier for the ingestion job. Use this to poll status and to commit the upload.
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.
Human-readable message describing the upload result.
Example
{ "status": "pending"}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
Conflict — resource state prevents the operation
Payload too large
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “ Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the database could not serve the request