Skip to main content
POST
Upload

Authorizations

X-API-Key
string
header
required

Organization API key

Body

application/json
dataset
string
required

Dataset name to upload these trajectories into.

Required string length: 1 - 256
trajectories
Trajectories · object[]

Trajectory payloads to validate, store, and index.

Maximum array length: 100000

Response

Successful Response

uploaded
integer
required

Number of trajectories accepted for storage.

skipped
integer
required

Number of trajectories skipped by validation or deduplication.

failures
BatchItemFailure · object[]

Structured batch-level upload failures, if any.

message
string | null

Human-readable upload summary.

partial_success
boolean
default:false

True when some trajectories uploaded but one or more errors occurred.

trajectories
TrajectoryUploadItem · object[]

Per-trajectory upload mapping for correlating caller ids to trajectory ids.