---
title: "Tileset API"
description: "API for managing tilesets and uploaded data in MapTiler."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs-qmgv.pages.dev/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Tileset API

MapTiler’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.

## Tileset API reference

Configure your environment settings below to update code samples:

-   **Client Libraries** – select your preferred programming language of the code examples.

  Scalar API Reference

-   [
    
    Introduction
    
    ](#description/introduction)
-   [
    
    tileset
    
    ](#tag/tileset)
    
    Close Group - tileset
    
    -   [
        
        List tilesets belonging to your account
        
        HTTP Method:  GET](#tag/tileset/GET/tiles)
    -   [
        
        Get tileset details
        
        HTTP Method:  GET](#tag/tileset/GET/tiles/{document_id})
    -   [
        
        Delete tileset
        
        HTTP Method:  DEL](#tag/tileset/DELETE/tiles/{document_id})
    -   [
        
        Change tileset metadata
        
        HTTP Method:  POST](#tag/tileset/POST/tiles/{document_id}/change_metadata)

[Powered by Scalar](https://www.scalar.com)

v1.0

OpenAPI 3.0.2

# MapTiler Service API

[Support](mailto:support@maptiler.com)

[](https://docs.maptiler.com/support/requests/)

[Terms of Service](https://www.maptiler.com/terms/)

Server

Server:https://service.maptiler.com/v1

MapTiler Service API

Client Libraries

Shell

Ruby

Node.js

PHP

Python

MoreSelect from all clients

Shell Curl

## tileset

​Copy link

tileset Operations

-   get/tiles
-   get/tiles/{document\_id}
-   delete/tiles/{document\_id}
-   post/tiles/{document\_id}/change\_metadata

### List tilesets belonging to your account

​Copy link

Auth Required

Query Parameters

-   cursorCopy link to cursor
    
    Type: string • base64
    
    Page cursor
    
-   limitCopy link to limit
    
    Type: integer
    
    min:  
    
    10
    
    max:  
    
    100
    
    Default
    
    50
    
    Page limit
    

Responses

-   200
    
    Page of tilesets
    
    application/json
    

Request Example for get/tiles

Shell Curl

```curl
curl https://service.maptiler.com/v1/tiles \
  --header 'Authorization: Basic username:password'
```

cURLCopy

cURLCopy

Status: 200

Show Schema 

```json
{
  "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
    }
  ]
}
```

JSONCopy

JSONCopy

Page of tilesets

### Get tileset details

​Copy link

Auth Required

Path Parameters

-   document\_idCopy link to document\_id
    
    Type: string Format: uuid
    
    required
    

Responses

-   200
    
    Tileset
    
    application/json
    

Request Example for get/tiles/_{document\_id}_

Shell Curl

```curl
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Basic username:password'
```

cURLCopy

cURLCopy

Status: 200

Show Schema 

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

JSONCopy

JSONCopy

Tileset

### Delete tileset

​Copy link

Auth Required

Path Parameters

-   document\_idCopy link to document\_id
    
    Type: string Format: uuid
    
    required
    

Responses

-   201
    
    Resource marked for deletion.
    

Request Example for delete/tiles/_{document\_id}_

Shell Curl

```curl
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000 \
  --request DELETE \
  --header 'Authorization: Basic username:password'
```

cURLCopy

cURLCopy

Status: 201

No Body

Resource marked for deletion.

### Change tileset metadata

​Copy link

Auth Required

Path Parameters

-   document\_idCopy link to document\_id
    
    Type: string Format: uuid
    
    required
    

Body·TilesetMetadataChange

application/json

-   attributionCopy link to attribution
    
    Type: string
    
    required
    
-   descriptionCopy link to description
    
    Type: string
    
    required
    
-   titleCopy link to title
    
    Type: string
    
    required
    

Responses

-   200
    
    Tileset
    
    application/json
    

Request Example for post/tiles/_{document\_id}_/change\_metadata

Shell Curl

```curl
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000/change_metadata \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic username:password' \
  --data '{
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}'
```

cURLCopy

cURLCopy

Status: 200

Show Schema 

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

JSONCopy

JSONCopy

Tileset