Mapbox Tilesets API

openapi: 3.1.0
info:
  title: Mapbox Tiling Service Activity Tilesets 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
servers:
- url: https://api.mapbox.com
  description: Mapbox API
tags:
- name: Tilesets
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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
  /tilesets/v1/queue:
    put:
      operationId: getQueueStatus
      summary: Retrieve queue status
      responses:
        '200':
          description: Queue status
        default:
          description: Error response
      tags:
      - Tilesets
  /tilesets/v1/validateRecipe:
    put:
      operationId: validateRecipe
      summary: Validate a tileset recipe
      responses:
        '200':
          description: Validation result
        default:
          description: Error response
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
    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
      tags:
      - Tilesets
  /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
      tags:
      - Tilesets
x-generated-from: https://docs.mapbox.com/api/maps/mapbox-tiling-service/
x-generated-by: claude-crawl-2026-05-08