Upload API

MapTiler Cloud has an Upload API that allows you to add new map tiles or update existing ones from the command line.

To simplify the uploading process, we recommend you use the CLI to run the commands. Follow the guide for installing and using the CLI.

Ingest tileset container into a new tileset

POST https://service.maptiler.com/v1/tiles/ingest

Request

You must include an Service Token with every API request

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json TilesetIngest Object

Ingest tileset container into existing tileset

POST https://service.maptiler.com/v1/tiles/{document_id}/ingest

Request

You must include an Service Token with every API request

Path Parameters

Parameters Type Description
document_id
string <uuid>

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json TilesetIngest Object

Get tileset ingest details

GET https://service.maptiler.com/v1/tiles/ingest/{ingest_id}

Request

You must include an Service Token with every API request

Path Parameters

Parameters Type Description
ingest_id
string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

Cancel tileset ingest

POST https://service.maptiler.com/v1/tiles/ingest/{ingest_id}/cancel

Request

You must include an Service Token with every API request

Path Parameters

Parameters Type Description
ingest_id
string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

Start tileset ingest processing

POST https://service.maptiler.com/v1/tiles/ingest/{ingest_id}/process

Request

You must include an Service Token with every API request

Path Parameters

Parameters Type Description
ingest_id
string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

TilesetIngestCreate Object

Property Type Description
filename
string
size
integer
size in bytes

TilesetIngest Object

Property Type Description
id
string <uuid>
document_id
string <uuid>
state
string
Allowed values: upload processing completed canceled failed
filename
string
size
number
size in bytes
errors
array [ Error Object]
progress
number
upload_url
string <URL>
URL for the uploaded resource

Error Object

Property Type Description
message
string