latestOpenAPI 3.1.0Proprietary2026-08-175035117.5 KB

019f79ecdd6c

Imports

Create an import job

Imports a geospatial file from a URL into a table in your data warehouse.

The job runs asynchronously — poll GET /v3/imports/{jobId} with the returned jobId.

By default CARTO guesses the schema of the file. To set it yourself, call POST /v3/imports/preview first, then pass autoguessing: false together with the schema you want.

Each account can run 5 import jobs concurrently.

post/v3/imports

Request body

connectionstring required

Name of the connection to import through.

urlstring uri required

Public URL of the file to import.

destinationstring required

Fully qualified name of the table to create.

overwriteboolean

Replace the destination table if it already exists.

autoguessingboolean

Let CARTO detect the schema. Set to false to import with the schema you provide.

dryRunboolean

Validate the import without writing anything. Can't be combined with overwrite.

ignoreErrorsboolean

Skip rows that fail to parse. Defaults to the value of autoguessing.

maxErrorsinteger

How many bad rows to tolerate. Defaults to 1000 when autoguessing is on, 0 otherwise.

wrapDateLineboolean

Wrap geometries that cross the antimeridian.

preserveSourceCrsboolean

Keep the source coordinate reference system instead of reprojecting to EPSG:4326.

metadataobject

Arbitrary metadata stored with the job.

Response

The import job was created.

jobIdstring uuid

status'pending' | 'running' | 'success' | 'failure' | 'cancelled'

success, failure and cancelled are final states.