{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/cesium/main/json-schema/cesium-asset-endpoint-schema.json",
  "title": "Asset Endpoint",
  "x-generated": "2026-10-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/cesium-api-openapi.yml#/components/schemas/AssetEndpoint",
  "type": "object",
  "properties": {
    "type": {
      "$ref": "#/$defs/AssetType"
    },
    "url": {
      "description": "The entry point url of the tileset, depending on the asset type. This url should be treated as an opaque link as the actual format may change any time. Do not cache it. Any URL manipulation should be done by parsing the URL, rather than through string manipulation.\n\n| Value | Description | Example |\n| - | - | - |\n| 3DTILES | The complete path to the tileset.json | https://assets.cesium.com/23912/tileset.json?v=4   |\n| TERRAIN | The base url of the terrain tileset | https://eu.assets.cesium.com/1da20c7e8-bb91-4d7f-9879-9d1bdb943422/ |\n| IMAGERY | The base url for both a TMS and WMTS compatible tileset | https://assets.ion.cesium.com/2194/ |\n| GLTF | The complete path to the model | https://assets.cesium.com/21944/model.glb |\n| KML | The complete path to the KML document | https://assets.cesium.com/KMLs/doc.kml |\n| CZML | The complete path to the CZML document | https://assets.ion.cesium.com/2367/doc.czml |\n| GEOJSON | The complete path to the GeoJSON document | https://assets.cesium.com/45387/doc.geojson |\n\nFor terrain and imagery, simply append the desired file or tile to the base url. For example, to retrieve the capabilities file for a WMTS imagery layer using the above example: https://assets.cesium.com/2194/WMTSCapabilities.xml.\n\nThis url should not be cached across application instances as it can change over time.\n",
      "type": "string"
    },
    "accessToken": {
      "description": "The token to be included with each tile request, using Bearer format. This token is different than the access token used throughout the rest of the REST API. It provides access to the asset for approximately one hour. To continue using the asset after the allotted time, simple re-request the endpoint for a new token.",
      "type": "string"
    },
    "attributions": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AssetEndpointAttribution"
      }
    }
  },
  "$defs": {
    "AssetEndpointAttribution": {
      "type": "object",
      "properties": {
        "html": {
          "description": "An HTML string defining the asset's required attribution. The rendered HTML must be accessible to the end users of your application.",
          "type": "string"
        },
        "collapsible": {
          "description": "If true, the rendered HTML must be shown on screen as long as the associated asset is also on screen. If false, the HTML can be shown on a separate panel or page.",
          "type": "boolean"
        }
      }
    },
    "AssetType": {
      "type": "string",
      "enum": [
        "3DTILES",
        "GLTF",
        "IMAGERY",
        "TERRAIN",
        "KML",
        "CZML",
        "GEOJSON"
      ],
      "description": "This asset's [type](#tag/Assets)."
    }
  }
}