Import shotgun assets

POST /import/shotgun/assets
Jwt authorization

Import Shotgun assets. Send a list of Shotgun asset entries in the JSON body. Returns created or updated assets with parent-child relationships.

application/json

Body Required

  • id integer

    Shotgun ID of the asset

  • code string

    Asset code

  • description string

    Asset description

  • sg_asset_type string

    Asset type name

  • project object

    Project information

    Hide project attribute Show project attribute object
    • id integer
  • parents array[object]

    Parent assets

    Hide parents attribute Show parents attribute object
    • id integer

Responses

  • 200 application/json

    Assets imported successfully

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

      Asset unique identifier

    • name string

      Asset name

    • description string

      Asset description

    • created_at string(date-time)

      Creation timestamp

    • updated_at string(date-time)

      Update timestamp
  • 400

    Invalid request body or data format error

POST /import/shotgun/assets 
curl \
 --request POST 'http://api.example.com/import/shotgun/assets' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '[{"id":12345,"code":"Asset01","parents":[{"id":22222}],"project":{"id":11111},"description":"Main character asset","sg_asset_type":"Character"}]'
Request example 
[
  {
    "id": 12345,
    "code": "Asset01",
    "parents": [
      {
        "id": 22222
      }
    ],
    "project": {
      "id": 11111
    },
    "description": "Main character asset",
    "sg_asset_type": "Character"
  }
]
Response examples (200) 
[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c25",
    "name": "Asset01",
    "description": "Main character asset",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T11:00:00Z"
  }
]