Datasets

Request Presigned Upload

Request presigned URL(s) for direct-to-S3 file upload.

post/ingest/upload/presigned

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

Request body

filenamestring required

Original filename being uploaded. Used to determine the file extension and content disposition.

file_sizeinteger required

Total file size in bytes. Used to decide between single-part and multipart upload.

content_typestring

MIME type to associate with the uploaded object.

kind'tiles3d' | 'pointcloud' nullable

'tiles3d' uploads a 3D Tiles tileset as a .zip or .3tz archive holding tileset.json. Omit it for any other file; a .zip without it is read as geospatial data, and a .3tz without it is refused. 'pointcloud' uploads a COPC point cloud as a .laz file; a .laz without it is refused.

Response

Successful Response

job_idstring uuid required

Identifier of the ingestion job created for this upload.

urlsstring[] required

One presigned PUT URL per part. Single-element list for single-part uploads.

s3_keystring required

Object key in the S3 bucket where the file will be stored.

upload_idstring nullable

S3 multipart upload ID, set only for multipart uploads.

part_sizeinteger nullable

Byte size of each part in a multipart upload.

Changes

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