Upload File

POST

/ingest/upload

curl --request POST \
  --url https://example.com/api/ingest/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=example

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.

Authorizations

• OAuth2PasswordBearer

Request Body ^required

Media type multipart/form-data

Body_upload_file_ingest_upload_post

object

file

required

File

string

Responses

201

Successful Response

Media type application/json

UploadResponse

object

job_id

required

Job Id

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

string format: uuid

status

Status

Initial job status. Always ‘pending’ on creation.

string

default: pending

message

required

Message

Human-readable message describing the upload result.

string

Example

{
  "status": "pending"
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}