---
title: "Create an Asset"
method: POST
path: "/skynet/asset"
tags: ["Tracking_Asset"]
---

# Create an Asset

`POST /skynet/asset`

## Query parameters

- `key` string, 32 character alphanumeric string, required

## Request body

- DtoCreateAssetReq
  - `custom_id` string — Set a unique ID for the new asset. If not provided, an ID will be automatically generated in UUID format. A valid custom_id can contain letters, numbers, "-", & "_" only. Please note that the ID of an asset can not be changed once it is created.
  - `description` string — Description for the asset.
  - `meta_data` MetaData — Any valid json object data. Can be used to save customized data. Max size is 65kb.
  - `name` string — Name of the asset. Use this field to assign a meaningful, custom name to the asset being created.
  - `tags` string[] — **This parameter will be deprecated soon! Please use the attributes parameter to add labels or markers for the asset.** Tags of the asset. tags can be used for filtering assets in operations like *Get Asset List* and asset **Search** methods. They can also be used for monitoring of assets using the **Monitor** methods after linking tags and asset. Valid tags are strings consisting of alphanumeric characters (A-Z, a-z, 0-9) along with the underscore ('_') and hyphen ('-') symbols.
  - `attributes` Attributes — attributes can be used to store custom information about an asset in key:value format. Use attributes to add any useful information or context to your assets like the vehicle type, shift timing etc. Moreover, these attributes can be used to filter assets in **Search**, **Monitor**, and *Get Asset List* queries. Please note that the maximum number of key:value pairs that can be added to an attributes object is 100. Also, the overall size of attributes object should not exceed 65kb.

## Response `200`

OK

- DtoCreateAssetResp
  - `status` string — A string indicating the state of the response. On successful responses, the value will be Ok. Indicative error messages are returned for different errors. See the [API Error Codes](#api-error-codes) section below for more information.
  - `data` object — An object containing the ID of the asset created.
    - `id` string — Unique ID of the asset created. It will be the same as custom_id, if provided. Else it will be an auto generated UUID. Please note this ID cannot be updated.
  - `message` string — Displays the error message in case of a failed request. If the request is successful, this field is not present in the response.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)