Mapbox Tiling Service (MTS) is a tool for creating vector tilesets. With MTS, you use sets of configuration options (tileset recipes) to transform your geospatial data into vector tiles. The resulting tiles are hosted on Mapbox servers for use in your applications.
openapi: 3.1.0
info:
title: Mapbox Tiling Service API
description: >-
Minimal OpenAPI 3.1 specification for the Mapbox Tiling Service,
covering tileset sources, changesets, tilesets, jobs, recipes,
queue, validation, and activity endpoints.
version: 1.0.0
x-generated-from: https://docs.mapbox.com/api/maps/mapbox-tiling-service/
x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://api.mapbox.com
description: Mapbox API
paths:
/tilesets/v1/sources/{username}/{id}:
post:
operationId: createSource
summary: Create a tileset source
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Source created
default:
description: Error response
get:
operationId: getSource
summary: Retrieve tileset source information
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Source information
default:
description: Error response
put:
operationId: replaceSource
summary: Replace a tileset source
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Source replaced
default:
description: Error response
delete:
operationId: deleteSource
summary: Delete a tileset source
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Source deleted
default:
description: Error response
/tilesets/v1/sources/{username}:
get:
operationId: listSources
summary: List tileset sources for a user
parameters:
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: List of sources
default:
description: Error response
/tilesets/v1/changesets/{username}/{id}:
post:
operationId: createChangeset
summary: Create a changeset
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Changeset created
default:
description: Error response
put:
operationId: replaceChangeset
summary: Replace a changeset
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Changeset replaced
default:
description: Error response
delete:
operationId: deleteChangeset
summary: Delete a changeset
parameters:
- name: username
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Changeset deleted
default:
description: Error response
/tilesets/v1/changesets/{username}:
get:
operationId: listChangesets
summary: List changesets for a user
parameters:
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: List of changesets
default:
description: Error response
/tilesets/v1/{tileset_id}:
post:
operationId: createTileset
summary: Create a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Tileset created
default:
description: Error response
patch:
operationId: updateTileset
summary: Update a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Tileset updated
default:
description: Error response
delete:
operationId: deleteTileset
summary: Delete a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'204':
description: Tileset deleted
default:
description: Error response
/tilesets/v1/{tileset_id}/publish:
post:
operationId: publishTileset
summary: Publish a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Publish job started
default:
description: Error response
/tilesets/v1/{tileset_id}/publish-changesets:
post:
operationId: publishChangesets
summary: Publish changesets for a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Publish job started
default:
description: Error response
/tilesets/v1/{tileset_id}/jobs:
get:
operationId: listTilesetJobs
summary: List jobs for a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: List of jobs
default:
description: Error response
/tilesets/v1/{tileset_id}/jobs/{job_id}:
get:
operationId: getTilesetJob
summary: Retrieve a tileset job
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
- name: job_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Job details
default:
description: Error response
/tilesets/v1/queue:
put:
operationId: getQueueStatus
summary: Retrieve queue status
responses:
'200':
description: Queue status
default:
description: Error response
/tilesets/v1/validateRecipe:
put:
operationId: validateRecipe
summary: Validate a tileset recipe
responses:
'200':
description: Validation result
default:
description: Error response
/tilesets/v1/{tileset_id}/recipe:
get:
operationId: getTilesetRecipe
summary: Retrieve a tileset recipe
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Recipe document
default:
description: Error response
patch:
operationId: updateTilesetRecipe
summary: Update a tileset recipe
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Recipe updated
default:
description: Error response
/tilesets/v1/{username}:
get:
operationId: listTilesets
summary: List tilesets for a user
parameters:
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: List of tilesets
default:
description: Error response
/v4/{tileset_id}.json:
get:
operationId: getTilesetTileJson
summary: Retrieve TileJSON for a tileset
parameters:
- name: tileset_id
in: path
required: true
schema:
type: string
responses:
'200':
description: TileJSON document
default:
description: Error response
/activity/v1/{username}/tilesets:
get:
operationId: getTilesetActivity
summary: Retrieve tileset activity for a user
parameters:
- name: username
in: path
required: true
schema:
type: string
responses:
'200':
description: Activity report
default:
description: Error response
components: {}