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 |
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 |
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 |
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 |
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 |
TilesetIngestCreate
| Property | Type | Description |
|---|---|---|
| filename | string | |
| size | integer | size in bytes
|
TilesetIngest
| 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 ] | |
| progress | number | |
| upload_url | string <URL> | URL for the uploaded resource
|
Error
| Property | Type | Description |
|---|---|---|
| message | string |
Using the OpenAPI Specification?
Get the openapi.yaml
APIs
- Maps API
- Static Maps API
- Tiles API
- Data API
- Geocoding API
- Geolocation API
- Coordinates API
- Weather API
- Other
- Description
Authentication
Admin API
On this page