Tileset API

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
Style: Comma separated values
limit integer
Page limit
>= 10 <= 100
Default: 50
Style: Comma separated values

Response

Code Content Description
200 application/json Page of tilesets response 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>

Response

Code Content Description
200 application/json Tileset response 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>

Response

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

Response

Code Content Description
200 application/json Tileset response object

Example response


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

Page of tilesets response object

Property Type Description
cursor string<uuid> or null
items array

Example response


{
  "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 response object

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

Example response


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

Tileset metadata object

Property Type Description
title string
description string
attribution string

Example


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