Create asset instance

POST /data/assets/{asset_id}/asset-asset-instances

Create a new asset instance inside a specific asset by instantiating another asset.

Path parameters

  • asset_id Required

    Unique identifier of the parent asset

application/json

Body Required

  • asset_to_instantiate_id string(uuid) Required

    Unique identifier of the asset to instantiate

  • description string

    Description for the asset instance

Responses

  • 201 application/json

    Asset instance successfully created

    Hide response attributes Show response attributes object
    • id string(uuid)

      Created asset instance unique identifier

    • asset_id string(uuid)

      Parent asset identifier

    • target_asset_id string(uuid)

      Target asset identifier

    • number string

      Instance number

    • description string

      Instance description

    • created_at string(date-time)

      Creation timestamp

POST /data/assets/{asset_id}/asset-asset-instances
curl \
 --request POST 'http://api.example.com/data/assets/a24a6ea4-ce75-4665-a070-57453082c25/asset-asset-instances' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"asset_to_instantiate_id":"a24a6ea4-ce75-4665-a070-57453082c25","description":"Asset instance description"}'
Request examples
{
  "asset_to_instantiate_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "description": "Asset instance description"
}
Response examples (201)
{
  "id": "f79f1jf9-hj20-9110-f625-02908537h70",
  "asset_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "target_asset_id": "b35b7fb5-df86-5776-b181-68564193d36",
  "number": "001",
  "description": "Main character instance",
  "created_at": "2023-01-01T12:00:00Z"
}