--- 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.maptiler.com/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 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 ## AuthenticationRequired Selected Auth Type: token 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 ``` Copy Copy Test Request(get /tiles) 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 ``` Copy Copy Test Request(get /tiles/{document\_id}) 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 ``` cURLCopy cURLCopy Test Request(delete /tiles/{document\_id}) 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' \ --data '{ "title": "North America", "description": "Processed on 04.05.2021", "attribution": null }' ``` cURLCopy cURLCopy Test Request(post /tiles/{document\_id}/change\_metadata) 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 ![](https://docs.maptiler.com/assets/img/open-api.png) Using the OpenAPI Specification? Get the [openapi.yaml](https://docs.maptiler.com/_data/cloud/admin-api/openapi.yml)