Cognite · Schema

Asset

A representation of a physical asset in Cognite Data Fusion, for example a factory or a piece of equipment.

Industrial IoTManufacturingIndustrial DataDigital TwinAsset ManagementTime SeriesIndustrial AI

Properties

Name Type Description
id integer A server-generated ID for the object.
externalId string The external ID provided by the client. Must be unique for the resource type.
name string The name of the asset.
parentId integer The parent node's ID used to specify parent-child relationship.
parentExternalId string The parent node's external ID used to specify the parent-child relationship.
description string The description of the asset.
dataSetId integer The ID of the dataset this asset belongs to.
metadata object Custom, application specific metadata. String key -> String value.
source string The source of this asset.
labels array A list of the labels associated with this resource item.
geoLocation object The geographic metadata of the asset.
rootId integer The ID of the root asset.
aggregates object Aggregated metrics for the asset.
createdTime integer The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.
lastUpdatedTime integer The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.
View JSON Schema on GitHub

JSON Schema

cognite-asset-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api-docs.cognite.com/schemas/asset",
  "title": "Asset",
  "description": "A representation of a physical asset in Cognite Data Fusion, for example a factory or a piece of equipment.",
  "type": "object",
  "required": ["id", "name", "createdTime", "lastUpdatedTime"],
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64",
      "description": "A server-generated ID for the object."
    },
    "externalId": {
      "type": "string",
      "maxLength": 255,
      "description": "The external ID provided by the client. Must be unique for the resource type."
    },
    "name": {
      "type": "string",
      "maxLength": 140,
      "description": "The name of the asset."
    },
    "parentId": {
      "type": "integer",
      "format": "int64",
      "description": "The parent node's ID used to specify parent-child relationship."
    },
    "parentExternalId": {
      "type": "string",
      "maxLength": 255,
      "description": "The parent node's external ID used to specify the parent-child relationship."
    },
    "description": {
      "type": "string",
      "maxLength": 500,
      "description": "The description of the asset."
    },
    "dataSetId": {
      "type": "integer",
      "format": "int64",
      "description": "The ID of the dataset this asset belongs to."
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Custom, application specific metadata. String key -> String value.",
      "maxProperties": 256
    },
    "source": {
      "type": "string",
      "maxLength": 128,
      "description": "The source of this asset."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["externalId"],
        "properties": {
          "externalId": {
            "type": "string",
            "maxLength": 255
          }
        }
      },
      "description": "A list of the labels associated with this resource item."
    },
    "geoLocation": {
      "type": "object",
      "description": "The geographic metadata of the asset.",
      "properties": {
        "type": {
          "type": "string",
          "enum": ["Feature"]
        },
        "geometry": {
          "type": "object"
        },
        "properties": {
          "type": "object"
        }
      }
    },
    "rootId": {
      "type": "integer",
      "format": "int64",
      "description": "The ID of the root asset."
    },
    "aggregates": {
      "type": "object",
      "description": "Aggregated metrics for the asset.",
      "properties": {
        "childCount": {
          "type": "integer"
        },
        "depth": {
          "type": "integer"
        },
        "path": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "format": "int64"
              }
            }
          }
        }
      }
    },
    "createdTime": {
      "type": "integer",
      "format": "int64",
      "description": "The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds."
    },
    "lastUpdatedTime": {
      "type": "integer",
      "format": "int64",
      "description": "The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cognite-asset"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.