List sidecar files attached to a 3D model asset

GET

/assets/{id}/companions

• Local development behind nginx (port 8088 by default)

Returns the set of companion files attached to this asset, in path order. The viewer fetches this list before mounting a 3D body and uses it to rewrite relative resource references (textures, MTL, .bin) through a LoadingManager URL modifier.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

List of companions (may be empty)

Array<object>

A sidecar file (texture, MTL, .bin, etc.) attached to a 3D model asset under a relative path. The viewer’s LoadingManager rewrites the model’s relative resource references through these entries so external resources resolve to the right content-addressed blob.

object

id

required

string format: uuid

asset_id

required

string format: uuid

path

required

Relative path the model file references this companion at — e.g. ‘character.mtl’ for an OBJ’s sibling .mtl, or ‘textures/foo.png’ for a glTF texture in a subdirectory.

string

Example

textures/character-a.png

content_type

required

string

Example

image/png

size_bytes

required

integer format: int64

created_at

required

string format: date-time

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed