Tileset API

MapTiler Cloud’s Tileset API allows you to manage your uploaded data via API. You can update the metadata, delete unwanted maps from your account, and much more.

List tilesets belonging to your account

GET https://service.maptiler.com/v1/tiles

Request

Security: Token Auth

Query Parameters

Parameters Type Description
cursor string <byte>
Page cursor
limit integer
Page limit
>= 10<= 100
Default: 50

Responses

Code Content Description
200 application/json TilesetPage Object

Get tileset details

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

Request

Security: Token Auth

Path Parameters

Parameters Type Description
document_id string <uuid>

Responses

Code Content Description
200 application/json Tileset Object

Delete tileset

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

Request

Security: Token Auth

Path Parameters

Parameters Type Description
document_id string <uuid>

Responses

Code Content Description
200 Resource marked for deletion.

Change tileset metadata

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

Request

Security: Token Auth

Path Parameters

Parameters Type Description
document_id string <uuid>

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json Tileset Object

TilesetPage Object

Property Type Description
cursor string <byte> or null
items array [Tileset Object]

TilesetPage example


  {
  "cursor": "aWQ9ImRlNzY0ZjE0LTRhMzktNGRhMS1iM2QxLTlhYmM5NzQyMzEzYSI=",
  "items": [
    {
      "id": "de764f14-4a39-4da1-b3d1-9abc9742313a",
      "title": "North America",
      "description": "Processed on 04.05.2021",
      "attribution": null
    },
    {
      "id": "b9d06d13-23e6-46ef-a54f-9279965d5761",
      "title": "South America",
      "description": "",
      "attribution": null
    }
  ]
}

Tileset Object

Property Type Description
id string <uuid>
title string
description string
attribution string

Tileset example


  {
  "id": "de764f14-4a39-4da1-b3d1-9abc9742313a",
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}

TilesetMetadataChange Object

Property Type Description
title string
description string
attribution string

TilesetMetadataChange example


  {
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}