Create an asset

To create an asset, you need:

  1. Asset type ID: Retrieve available asset types using List asset types.
  2. Field IDs (optional): Get the fields associated with your asset type using List an asset type's fields.
  3. Site ID (optional): Retrieve available sites.
  4. Status option ID (optional): Assign a status to the asset using status_option_ids. The status option must belong to the status group associated with the asset’s type. An asset type currently supports a single status group only, so provide at most one ID. You can find the status option IDs configured for your assets in the response from Get asset details.

To create multiple assets in a single request, use Create multiple assets.

Requirements

📘

If you get a 400 response, check that the asset type ID is valid and that each field you send is associated with the asset type.

Body Params

The parameters for CreateAsset

The parameters for CreateAsset

string
required

Customer specified identifier for the asset. Unique per org.

fields
array of objects

List of fields based on the type of asset.

fields
string

Unique ID of site to be associated with asset.

profile_image
object

This object is used to define media object associated with an asset,
including profile image, photos and documents.

string
required

Global unique identifier of the asset type.

status_option_ids
array of strings

ID of the status option to assign. Each entry must belong to the status group associated with the asset type. You can only add one entry.

status_option_ids
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json