API Reference

Collections

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Update

collections.update(strcollection_id, CollectionUpdateParams**kwargs) -> CollectionUpdateResponse

PUT/collections/{collectionId}

Update the name and/or thumbnail of a Collection

ParametersExpand Collapse

collection_id: str

name: Optional[str]

The new name for the Collection

thumbnail: Optional[str]

The AssetId of the image you want to use as a thumbnail for the collection. Set to null to unset the thumbnail.

ReturnsExpand Collapse

class CollectionUpdateResponse: …

collection: Collection

id: str

The collection ID (example: “asset_GTrL3mq4SXWyMxkOHRxlpw”)

asset_count: float

created_at: str

The collection creation date as an ISO string (example: “2023-02-03T11:19:41.579Z”)

item_count: float

model_count: float

name: str

The collection name

owner_id: str

The owner ID (example: “dcf121faaa1a0a0bbbd9ca1b73d62aea”)

updated_at: str

The collection last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)

thumbnail: Optional[CollectionThumbnail]

The thumbnail for the collection (if any)

asset_id: str

url: str

Update

Python

HTTP

TypeScript

Python

import os
from scenario_sdk import Scenario

client = Scenario(
    api_key=os.environ.get("SCENARIO_SDK_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SCENARIO_SDK_API_SECRET"),  # This is the default and can be omitted
)
collection = client.collections.update(
    collection_id="collectionId",
)
print(collection.collection)

200 example

{
  "collection": {
    "id": "id",
    "assetCount": 0,
    "createdAt": "createdAt",
    "itemCount": 0,
    "modelCount": 0,
    "name": "name",
    "ownerId": "ownerId",
    "updatedAt": "updatedAt",
    "thumbnail": {
      "assetId": "assetId",
      "url": "url"
    }
  }
}

Returns Examples

200 example

{
  "collection": {
    "id": "id",
    "assetCount": 0,
    "createdAt": "createdAt",
    "itemCount": 0,
    "modelCount": 0,
    "name": "name",
    "ownerId": "ownerId",
    "updatedAt": "updatedAt",
    "thumbnail": {
      "assetId": "assetId",
      "url": "url"
    }
  }
}