POST /data/scenes/{scene_id}/asset-instances

Create an asset instance on a specific scene.

Path parameters

  • scene_id Required

    Unique identifier of the scene

application/json

Body Required

  • asset_id string(uuid) Required

    Asset identifier to create instance from

  • description string

    Instance description

Responses

  • 201 application/json

    Asset instance successfully created on scene

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

      Asset instance unique identifier

    • asset_id string(uuid)

      Asset identifier

    • scene_id string(uuid)

      Scene identifier

    • number string

      Instance number

    • description string

      Instance description

POST /data/scenes/{scene_id}/asset-instances
curl -X POST "http://api.example.com/data/scenes/i02i4mi2-km53-2443-i958-35231870k03/asset-instances" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "asset_id": "c46c8gc6-eg97-6887-c292-79675204e47",
  "description": "Main character instance"
}'
import requests

url = "http://api.example.com/data/scenes/i02i4mi2-km53-2443-i958-35231870k03/asset-instances"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = {
    "asset_id": "c46c8gc6-eg97-6887-c292-79675204e47",
    "description": "Main character instance"
}

response = requests.post(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())
curl \
 --request POST 'http://api.example.com/data/scenes/i02i4mi2-km53-2443-i958-35231870k03/asset-instances' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"asset_id":"c46c8gc6-eg97-6887-c292-79675204e47","description":"Main character instance"}'
Request examples
{
  "asset_id": "c46c8gc6-eg97-6887-c292-79675204e47",
  "description": "Main character instance"
}
Response examples (201)
{
  "id": "j13j5nj3-ln64-3554-j069-46342981l14",
  "asset_id": "c46c8gc6-eg97-6887-c292-79675204e47",
  "scene_id": "i02i4mi2-km53-2443-i958-35231870k03",
  "number": "001",
  "description": "Main character instance"
}