openapi: 3.1.0
info:
  title: MapTiler Server Admin API
  version: 4.8.0
  description: |-
    Reference for MapTiler Server Admin API.

    🔑 You are required to authorize every request using your Credentials token in the request header.

    The token can be acquired in the "Credentials" section of settings.

    Through the Admin API, you can run maps' and tiles' operations, such as get list, get detail, publish, remove, and more.
  termsOfService: https://www.maptiler.com/server/license/
  contact:
    name: Support
    email: support@maptiler.com
    url: https://docs.maptiler.com
  license:
    name: MapTiler Server License Agreement
    url: https://www.maptiler.com/server/license/
servers:
  - description: MapTiler Server Admin API
    url: http://{host}/api/v1/admin
    variables:
      host:
        default: localhost:3650
        description: Hostname (and port) of your MapTiler Server instance.
security:
  - Token: []
tags:
  - name: Maps
    description: Manage self-hosted vector and raster maps.
  - name: Tiles
    description: Manage self-hosted tilesets.
  - name: Tile Ingest
    description: Ingest new tilesets from uploaded files.
paths:
  /maps:
    get:
      operationId: mapList
      summary: List maps
      description: Lists maps from maps directory. It can be paginated with offset and limit parameters, otherwise first 50 items are returned.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/listOffset'
        - $ref: '#/components/parameters/listLimit'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapList'
        '400':
          $ref: '#/components/responses/400'
  /maps/{id}:
    get:
      operationId: mapDetail
      summary: Detail of the map
      description: Gets information about the given map.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/mapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
    post:
      operationId: mapChange
      summary: Change metadata of the map
      description: Changes metadata (format, quality, published) of the given map.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/mapId'
      requestBody:
        $ref: '#/components/requestBodies/MapChange'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
    delete:
      operationId: mapDelete
      summary: Delete the map
      description: Deletes the given map. Before deleting, it is automatically unpublished and cannot be served anymore.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/mapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapRemove'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /maps/{id}/publish:
    post:
      operationId: mapPublish
      summary: Publish the map
      description: Publishes the given map. Does nothing, if the map is already published.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/mapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /maps/{id}/unpublish:
    post:
      operationId: mapUnpublish
      summary: Unpublish the map
      description: Unpublishes the given map. Does nothing, if the map is already unpublished.
      x-since: 4.3.0
      tags:
        - Maps
      parameters:
        - $ref: '#/components/parameters/mapId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MapItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles:
    get:
      operationId: tileList
      summary: List the tiles
      description: Lists the tilesets from the tiles directory. Can be paginated with offset and limit parameters, otherwise first 50 items are returned.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/listOffset'
        - $ref: '#/components/parameters/listLimit'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileList'
        '400':
          $ref: '#/components/responses/400'
  /tiles/rescan:
    post:
      operationId: tileRescan
      summary: Rescan the tiles
      description: Rescans tiles directory. Does NOT remove dead files.
      x-since: 4.2.0
      tags:
        - Tiles
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileList'
        '400':
          $ref: '#/components/responses/400'
  /tiles/reload:
    post:
      operationId: tileReload
      summary: Reload the tiles
      description: Rescans the tiles directory and automatically removes dead files. Optionally may remove remote tile records.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/removeRemote'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileRemove'
        '400':
          $ref: '#/components/responses/400'
  /tiles/add:
    post:
      operationId: tileAdd
      summary: Add remote tile
      description: Adds MTPKG remote tile record.
      x-since: 4.6.0
      tags:
        - Tiles
      requestBody:
        $ref: '#/components/requestBodies/TileAdd'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileItem'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/{id}:
    get:
      operationId: tileDetail
      summary: Detail of the tileset
      description: Gets information about the given tileset.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/tileId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
    post:
      operationId: tileChange
      summary: Change metadata of the given tileset
      description: Changes metadata (name, published) of the given tileset.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/tileId'
      requestBody:
        $ref: '#/components/requestBodies/TileChange'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
    delete:
      operationId: tileDelete
      summary: Delete the tileset
      description: Deletes the given tileset. Before deleting, it is automatically unpublished and cannot be served anymore.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/tileId'
        - $ref: '#/components/parameters/deleteForce'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileRemove'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/{id}/publish:
    post:
      operationId: tilePublish
      summary: Publish the tileset
      description: Publishes the given tileset. Does nothing, if the tileset is already published.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/tileId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/{id}/unpublish:
    post:
      operationId: tileUnpublish
      summary: Unpublish the tileset
      description: Unpublishes the given tileset. Does nothing, if the tileset is already unpublished.
      x-since: 4.2.0
      tags:
        - Tiles
      parameters:
        - $ref: '#/components/parameters/tileId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileItemDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/ingest:
    post:
      operationId: tileIngestCreate
      summary: Create new tileset ingest
      description: Creates a new tileset ingest.
      x-since: 4.3.0
      tags:
        - Tile Ingest
      requestBody:
        $ref: '#/components/requestBodies/TileIngestCreate'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileIngestDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/ingest/{id}:
    get:
      operationId: tileIngestDetail
      summary: Detail of the given tileset ingest
      description: Gets information about the given tileset ingest.
      x-since: 4.3.0
      tags:
        - Tile Ingest
      parameters:
        - $ref: '#/components/parameters/tileIngestId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileIngestDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/ingest/{id}/upload:
    put:
      operationId: tileIngestUpload
      summary: Upload data to tileset ingest
      description: Uploads sent data to the given tileset ingest.
      x-since: 4.3.0
      tags:
        - Tile Ingest
      parameters:
        - $ref: '#/components/parameters/tileIngestId'
      security: []
      requestBody:
        $ref: '#/components/requestBodies/TileIngestUpload'
      responses:
        '200':
          description: OK, file is completely uploaded
        '308':
          description: Part of the file data is uploaded
          headers:
            Range:
              description: Specifies the range of uploaded bytes
              schema:
                type: string
                examples:
                  - Range="bytes 0-1024"
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
  /tiles/ingest/{id}/process:
    post:
      operationId: tileIngestProcess
      summary: Process tileset ingest
      description: Processes the data of given tileset ingest and creates a tileset with given document_id
      x-since: 4.3.0
      tags:
        - Tile Ingest
      parameters:
        - $ref: '#/components/parameters/tileIngestId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TileIngestDetail'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
components:
  parameters:
    listLimit:
      name: limit
      in: query
      description: Maximum number of items which will be returned.
      x-since: 4.2.0
      example: 50
      required: false
      schema:
        type: integer
        default: 50
    listOffset:
      name: offset
      in: query
      description: The starting position of returned list of items.
      x-since: 4.2.0
      example: 10
      required: false
      schema:
        type: integer
        default: 0
    mapId:
      name: id
      in: path
      description: Identifier of the map.
      x-since: 4.3.0
      example: streets
      required: true
      schema:
        type: string
    removeRemote:
      name: removeRemote
      in: query
      description: Removes remote tile records. Does not remove files from the remote server.
      x-since: 4.6.0
      example: true
      required: false
      schema:
        type: boolean
        default: false
    tileId:
      name: id
      in: path
      description: Identifier of the tileset
      x-since: 4.2.0
      example: b142543e-ffa2-4994-acbc-825012e75a97
      required: true
      schema:
        type: string
    tileIngestId:
      name: id
      in: path
      description: Identifier of the ingesting tileset
      example: b4362feb-6573-451e-b707-cada462c37f7
      required: true
      schema:
        type: string
    deleteForce:
      description: Enables cascading deletion. When true, automatically deletes this tileset when used by other resources (virtual tilesets).
      example: true
      in: query
      name: force
      required: false
      schema:
        default: false
        type: boolean
      x-since: 4.8.0
  requestBodies:
    MapChange:
      description: A JSON object containing metadata information
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MapChange'
    TileAdd:
      description: A JSON object containing storage and url for remote tile
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TileAdd'
    TileChange:
      description: A JSON object containing metadata information
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TileChange'
    TileIngestCreate:
      description: JSON containing file name and file size for new tile ingest
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TileIngestCreate'
    TileIngestUpload:
      description: A binary file
      content:
        application/octet-stream:
          schema:
            $ref: '#/components/schemas/BinaryFile'
  responses:
    '400':
      description: Invalid request
      content:
        application/json:
          schema:
            type: object
            title: Errors
            properties:
              errors:
                $ref: '#/components/schemas/Error'
    '404':
      description: Requested item not found
      content:
        application/json:
          schema:
            type: object
            title: Errors
            properties:
              errors:
                $ref: '#/components/schemas/Error'
  schemas:
    BinaryFile:
      type: string
      format: binary
    Error:
      type: array
      items:
        type: object
        title: Error
        properties:
          message:
            type: string
            examples:
              - Error message
        description: Error message
      description: List of errors
    MapChange:
      type: object
      title: MapChange
      properties:
        format:
          description: New format
          enum:
            - jpeg
            - png
            - webp
          type: string
          examples:
            - jpeg
        quality:
          description: New quality in percent
          minimum: 0
          maximum: 100
          type: integer
          examples:
            - 92
        published:
          description: New state of the map serving
          type: boolean
          examples:
            - true
    MapItem:
      type: object
      title: MapItem
      properties:
        id:
          description: Identifier of the map
          type: string
          examples:
            - streets
        name:
          description: Name of the map
          type: string
          examples:
            - streets
        title:
          description: Title of the map
          type: string
          examples:
            - Streets
        published:
          description: Says whether the map is published
          type: boolean
          examples:
            - true
        format:
          description: Selected format of the map rasterization
          enum:
            - jpeg
            - png
            - webp
          type: string
          examples:
            - jpeg
      required:
        - id
        - name
        - title
        - published
        - format
      description: Map item
    MapItemDetail:
      type: object
      title: MapItemDetail
      properties:
        id:
          description: Identifier of the map
          type: string
          examples:
            - streets
        name:
          description: Name of the map
          type: string
          examples:
            - streets
        title:
          description: Title of the map
          type: string
          examples:
            - Streets
        published:
          description: Says whether the map is published
          type: boolean
          examples:
            - true
        format:
          description: Selected format of the map rasterization
          enum:
            - jpeg
            - png
            - webp
          type: string
          examples:
            - jpeg
        quality:
          description: Format quality of the map rasterization
          minimum: 0
          maximum: 100
          type: integer
          examples:
            - 92
        urls:
          $ref: '#/components/schemas/MapItemDetailUrls'
      required:
        - id
        - name
        - title
        - published
        - format
      description: Map detail
    MapItemDetailUrls:
      type: object
      title: MapItemDetailUrls
      description: Accessible URLs for the map
      properties:
        embeddable:
          description: URL for the embeddable viewer
          type: string
          examples:
            - http://localhost:3650/api/maps/streets
        ogcTiles:
          description: URL for OGC API - Tiles
          type: string
          examples:
            - http://localhost:3650/api/maps/streets/tiles
        stylejson:
          description: URL for styleJSON
          type: string
          examples:
            - http://localhost:3650/api/maps/streets/style.json
        tilejson:
          description: URL for tileJSON 516px, null when the server cannot rasterize
          type:
            - 'null'
            - string
          examples:
            - http://localhost:3650/api/maps/streets/tiles.json
        tilejson256:
          description: URL for tileJSON 256px, null when the server cannot rasterize
          type:
            - 'null'
            - string
          examples:
            - http://localhost:3650/api/maps/streets/256/tiles.json
        wms:
          description: URL for WMS, available only with valid license, must be enabled in settings, null when the server cannot rasterize
          type:
            - 'null'
            - string
          examples:
            - http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities
        wmts:
          description: URL for WMTS
          type: string
          examples:
            - http://localhost:3650/api/maps/streets/WMTSCapabilities.xml
        xyz:
          description: URL for XYZ 512px, null when the server cannot rasterize
          type:
            - 'null'
            - string
          examples:
            - http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg
        xyz256:
          description: URL for XYZ 256px, null when the server cannot rasterize
          type:
            - 'null'
            - string
          examples:
            - http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg
        staticAuto:
          description: URL template for auto-fitted static map, available only with valid license, null when the server cannot rasterize
          examples:
            - http://localhost:3650/api/maps/streets/static/auto/{width}x{height}.jpg
          type:
            - 'null'
            - string
        staticBounds:
          description: URL template for bounds-based static map, available only with valid license, null when the server cannot rasterize
          examples:
            - http://localhost:3650/api/maps/streets/static/{minx},{miny},{maxx},{maxy}/{width}x{height}.jpg
          type:
            - 'null'
            - string
        staticCenter:
          description: URL template for center-based static map, available only with valid license, null when the server cannot rasterize
          examples:
            - http://localhost:3650/api/maps/streets/static/{lon},{lat},{zoom}/{width}x{height}.jpg
          type:
            - 'null'
            - string
        tmsRaster:
          description: URL for raster TMS
          examples:
            - http://localhost:3650/api/maps/streets/raster/tms
          type: string
        tmsVector:
          description: URL for vector TMS
          examples:
            - http://localhost:3650/api/maps/streets/vector/tms
          type: string
        wmsGlobal:
          description: URL for WMS of all maps, null unless WMS is served and enabled for all layers in settings
          examples:
            - http://localhost:3650/api/maps/wms?service=WMS&request=GetCapabilities
          type:
            - 'null'
            - string
        wmtsGlobal:
          description: URL for WMTS of all maps, null unless enabled for all layers in settings
          examples:
            - http://localhost:3650/api/WMTSCapabilities.xml
          type:
            - 'null'
            - string
      required:
        - embeddable
        - ogcTiles
        - staticAuto
        - staticBounds
        - staticCenter
        - stylejson
        - tilejson
        - tilejson256
        - tmsRaster
        - tmsVector
        - wms
        - wmsGlobal
        - wmts
        - wmtsGlobal
        - xyz
        - xyz256
    MapList:
      type: object
      title: MapList
      required:
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/MapItem'
    MapRemove:
      type: object
      title: MapRemove
      required:
        - removed
      properties:
        removed:
          type: array
          items:
            type: string
            examples:
              - streets
          description: The names of removed maps
    TileAdd:
      type: object
      title: TileAdd
      properties:
        storage:
          description: Storage type of remote server
          enum:
            - http
            - s3
          type: string
          examples:
            - http
        url:
          description: URL of remote file
          type: string
          examples:
            - https://data.maptiler.com/downloads/tileset/europe/switzerland/zurich.mtpkg
    TileIngestCreate:
      type: object
      title: TileIngestCreate
      properties:
        filename:
          description: Tileset file name
          type: string
          examples:
            - maptiler-osm.mbtiles
        size:
          description: Size of the uploading file
          type: integer
          examples:
            - 6930432
    TileIngestDetail:
      type: object
      title: TileIngestDetail
      properties:
        id:
          description: Identifier of the tile ingest
          type: string
          examples:
            - b4362feb-6573-451e-b707-cada462c37f7
        document_id:
          description: Identifier of the ingesting tileset
          type: string
          examples:
            - 86e2836d-d30e-4767-85f0-12a33bed2393
        filename:
          description: Filename of the ingesting tileset
          type: string
          examples:
            - maptiler-osm.mbtiles
        size:
          description: Size of the ingesting tileset
          type: integer
          examples:
            - 6930432
        state:
          description: Current state of the ingest
          enum:
            - upload
            - uploading
            - completed
            - processing
            - failed
          type: string
          examples:
            - upload
        upload_url:
          description: URL for uploading data
          type: string
          examples:
            - http://localhost:3650/api/v1/admin/tiles/ingest/b4362feb-6573-451e-b707-cada462c37f7/upload
        errors:
          $ref: '#/components/schemas/Error'
        date_created:
          description: Date and time the ingest was created
          examples:
            - Thu, 01 Jan 2026 00:00:00 GMT
          type: string
        type:
          description: Type of the ingested data
          enum:
            - geocoding
            - map
            - mapPackage
            - tile
          examples:
            - tile
          type: string
      required:
        - id
        - document_id
        - filename
        - size
        - state
        - date_created
        - type
      description: Tile ingest item
    TileChange:
      type: object
      title: TileChange
      properties:
        name:
          description: New name
          type: string
          examples:
            - maptiler-osm
        published:
          description: New state of the tile serving
          type: boolean
          examples:
            - true
    TileItem:
      type: object
      title: TileItem
      properties:
        id:
          description: Identifier of the tileset
          type: string
          examples:
            - b142543e-ffa2-4994-acbc-825012e75a97
        name:
          description: Name of the tileset
          type: string
          examples:
            - maptiler-osm
        title:
          description: Title of the tileset
          type: string
          examples:
            - Maptiler OSM Data
        fileName:
          description: File name
          type: string
          examples:
            - maptiler-osm.mbtiles
        published:
          description: Says whether the tileset is published
          type: boolean
          examples:
            - true
        type:
          description: Type of the data
          enum:
            - geopackage
            - mbtiles
            - mtpkg
            - postgis
            - virtual
          type: string
          examples:
            - mbtiles
        tileType:
          description: File type of the data
          enum:
            - raster
            - terrain
            - vector
          type: string
          examples:
            - vector
      required:
        - id
        - name
        - title
        - fileName
        - published
        - type
      description: Tile item
    TileItemDetail:
      type: object
      title: TileItemDetail
      properties:
        id:
          description: Identifier of the tileset
          type: string
          examples:
            - b142543e-ffa2-4994-acbc-825012e75a97
        name:
          description: Name of the tileset
          type: string
          examples:
            - maptiler-osm
        title:
          description: Title of the tileset
          type: string
          examples:
            - Maptiler OSM Data
        fileName:
          description: File name
          type: string
          examples:
            - maptiler-osm.mbtiles
        published:
          description: Says whether the tileset is published
          type: boolean
          examples:
            - true
        type:
          description: Type of the data
          enum:
            - geopackage
            - mbtiles
            - mtpkg
            - postgis
            - virtual
          type: string
          examples:
            - mbtiles
        tileType:
          description: File type of the data
          enum:
            - raster
            - terrain
            - vector
          type: string
          examples:
            - vector
        urls:
          $ref: '#/components/schemas/TileItemDetailUrls'
      required:
        - id
        - name
        - title
        - fileName
        - published
        - type
      description: Tile details
    TileItemDetailUrls:
      type: object
      title: TileItemDetailUrls
      description: Accessible URLs for the tileset
      properties:
        embeddable:
          description: URL for embeddable viewer
          type: string
          examples:
            - http://localhost:3650/api/tiles/maptiler-osm
        ogcTiles:
          description: URL for OGC API - Tiles
          type: string
          examples:
            - http://localhost:3650/api/tiles/maptiler-osm/tiles
        tilejson:
          description: URL for tileJSON / layerJSON
          type: string
          examples:
            - http://localhost:3650/api/tiles/maptiler-osm/tiles.json
        wmts:
          description: URL for WMTS
          type: string
          examples:
            - http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml
        xyz:
          description: URL for XYZ
          type: string
          examples:
            - http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}
    TileList:
      type: object
      title: TileList
      required:
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/TileItem'
    TileRemove:
      type: object
      title: TileRemove
      required:
        - removed
      properties:
        removed:
          type: array
          items:
            type: string
            examples:
              - maptiler-osm
          description: The names of removed tilesets
  securitySchemes:
    Token:
      description: |-
        Your own token can be acquired from http://localhost:3650/admin/settings/credentials. 

        Example: "Token cd43cX91d84044cad11e2fre48afedc9_f80f4be2adfa6dfb6bc489229cad877d6cfcad293f48fae6e77898f2aab65607"
      type: http
      scheme: Token