Collections
Update Collections
- Documentation
- API Reference
- Community
- Headless
- GETAbout Shade Server
- GETConfig
- GETServer Status
- GETSearch Assets
- GETServer Usage Analytics
- GETAssets Searched
- GETServer Heartbeat
- GETKill Server
- GETExport File Path
- POSTAdd Asset to Source
- PUTAdd Tags to Asset
- DELDelete Assets
- GETAsset Roots
- GETAssets Linked to Other Assets
- GETAsset Collections
- GETIndividual Assets
- GETVisually Similar Assets
- GETAmount of Assets For Each Type
- POSTLink to Assets
- POSTLink to Asset Types
- GETAll Assets
- POSTMove Assets
- DELRemove Assets from Source
- PUTAsset Name
- GETDownload Assets
- GETAsset Type
- GETObjects Detected in an Asset
- DELUnlink Assets
- PUTUpdate Assets
- POSTAdd Asset to Collection
- GETAssets in a Collection
- POSTCreate a Collection
- DELDelete a Collection
- GETGet a Collection
- GETGet Filters
- PUTUpdate Collections
- GETAll Collections
- DELDelete Asset from Collection
- POSTSave Assets
- PUTUpdate Collections
- POSTGenerate New Assets
- POSTAdd Asset to Root
- GETIndexing Status
- POSTSync Asset Roots
- GETGet Asset Root
- GETDownload Progress
- GETGet Indexing Limit
- GETIndexing Queue
- GETFile Types Seen
- POSTPause Indexing
- DELDelete All Indexing Roots
- DELDelete Specific Indexing Root
- GETAsset from Index
- POSTReset Indexing
- POSTSet Indexing Limit
- PUTUpdate Player Numbers
- POSTRemove Background
- GETSearch Assets
API Documentation
Endpoint Examples
Assets
Collections
Generate
Indexing
Players
Remove Background
Search
Collections
Update Collections
Update a collection
PUT
/
collections
/
{collection_id}
collection_id
The collection id ยท string
*
collection_id
Required
string
The id of the collection to be updated
Body_update_collection_collections__collection_id__put ยท object
name
Collection name ยท string
name
string
The new name for the collection
description
Collection description ยท string
description
string
The new description for the collection
{
"name": "string",
"description": "string"
}
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"type": "auto",
"tags": [
"<string>"
],
"filters": {},
"preview_asset": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"user_description": "<string>",
"description": "<string>",
"signature": 123,
"updated": "2023-11-07T05:31:56Z",
"created": "2023-11-07T05:31:56Z",
"file_created": "2023-11-07T05:31:56Z",
"file_modified": "2023-11-07T05:31:56Z",
"timestamp": 123,
"path": "<string>",
"type": "IMAGE",
"tags": [
"<string>"
],
"size_bytes": 123,
"source": [
"<string>"
],
"objects": [
"<any>"
],
"transcription": "<string>",
"rating": 123,
"blurhash": "<string>",
"palette": [
[
123
]
],
"ocr": "<string>",
"category": "<string>",
"extension": "<string>",
"license": "cc-by",
"asset_metadata": {},
"preview_images": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"thumbnail": "<string>",
"created": "2023-11-07T05:31:56Z"
}
],
"texture_data": {},
"integration_data": {},
"proxy_path": "<string>",
"ai_indexed": true,
"comments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z"
}
],
"candid": true,
"faces_present": true,
"red_eye": true,
"eyes_open": true,
"people_posing": true,
"blurry": true,
"focused": true,
"good_exposure": true,
"players": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"image_blob": "<string>"
}
]
},
"preview_image": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"thumbnail": "<string>",
"created": "2023-11-07T05:31:56Z"
}
}
Path Parameters
collection_id
string
requiredThe id of the collection to be updated
Body
application/json
name
string
The new name for the collection
description
string
The new description for the collection
Response
200 - application/json
id
string
requiredname
string
requireddescription
string
requiredtype
enum<string>
requiredAn enumeration.
Available options:
auto
, user
tags
string[]
requiredfilters
object
requiredpreview_asset
object
preview_asset.id
string
requiredpreview_asset.name
string
requiredpreview_asset.user_description
string
preview_asset.description
string
requiredpreview_asset.signature
integer
requiredpreview_asset.updated
string
requiredpreview_asset.created
string
requiredpreview_asset.file_created
string
preview_asset.file_modified
string
preview_asset.timestamp
integer
preview_asset.path
string
requiredpreview_asset.type
enum<string>
requiredAn enumeration.
Available options:
IMAGE
, VIDEO
, AUDIO
, OBJECT
, MAYA
, NUKE
, MAX
, HDR
, HDRI
, BLENDER
, HOUDINI
, PHOTOSHOP
, UNREAL
, UNITY
, TEXTURE
, SEQUENCE
, AFTER_EFFECTS
, MOGRT
, ILLUSTRATOR
, EXR
, DOCUMENT
, STOCK
, OTHER
preview_asset.tags
string[]
requiredpreview_asset.size_bytes
integer
requiredpreview_asset.source
string[]
requiredpreview_asset.objects
any[]
requiredpreview_asset.transcription
string
preview_asset.rating
number
preview_asset.blurhash
string
requiredpreview_asset.palette
array
requiredpreview_asset.ocr
string
preview_asset.category
string
preview_asset.extension
string
requiredpreview_asset.license
enum<string>
requiredAsset Licenses
Available options:
cc-by
, cc-by-sa
, cc-by-nd
, cc-by-nc
, cc-by-nc-sa
, cc-by-nc-nd
, cc0
, unknown
, other
preview_asset.asset_metadata
object
requiredpreview_asset.preview_images
object[]
requiredpreview_asset.preview_images.id
string
requiredpreview_asset.preview_images.path
string
requiredpreview_asset.preview_images.thumbnail
string
requiredpreview_asset.preview_images.created
string
requiredpreview_asset.texture_data
object
preview_asset.integration_data
object
preview_asset.proxy_path
string
preview_asset.ai_indexed
boolean
requiredpreview_asset.comments
object[]
requiredpreview_asset.comments.id
string
requiredpreview_asset.comments.content
string
requiredpreview_asset.comments.created
string
requiredpreview_asset.comments.updated
string
requiredpreview_asset.candid
boolean
preview_asset.faces_present
boolean
preview_asset.red_eye
boolean
preview_asset.eyes_open
boolean
preview_asset.people_posing
boolean
preview_asset.blurry
boolean
preview_asset.focused
boolean
preview_asset.good_exposure
boolean
preview_asset.players
object[]
preview_asset.players.id
string
requiredpreview_asset.players.number
integer
requiredpreview_asset.players.image_blob
string
requiredpreview_image
object
preview_image.id
string
requiredpreview_image.path
string
requiredpreview_image.thumbnail
string
requiredpreview_image.created
string
required{
"name": "string",
"description": "string"
}
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"type": "auto",
"tags": [
"<string>"
],
"filters": {},
"preview_asset": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"user_description": "<string>",
"description": "<string>",
"signature": 123,
"updated": "2023-11-07T05:31:56Z",
"created": "2023-11-07T05:31:56Z",
"file_created": "2023-11-07T05:31:56Z",
"file_modified": "2023-11-07T05:31:56Z",
"timestamp": 123,
"path": "<string>",
"type": "IMAGE",
"tags": [
"<string>"
],
"size_bytes": 123,
"source": [
"<string>"
],
"objects": [
"<any>"
],
"transcription": "<string>",
"rating": 123,
"blurhash": "<string>",
"palette": [
[
123
]
],
"ocr": "<string>",
"category": "<string>",
"extension": "<string>",
"license": "cc-by",
"asset_metadata": {},
"preview_images": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"thumbnail": "<string>",
"created": "2023-11-07T05:31:56Z"
}
],
"texture_data": {},
"integration_data": {},
"proxy_path": "<string>",
"ai_indexed": true,
"comments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z"
}
],
"candid": true,
"faces_present": true,
"red_eye": true,
"eyes_open": true,
"people_posing": true,
"blurry": true,
"focused": true,
"good_exposure": true,
"players": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"image_blob": "<string>"
}
]
},
"preview_image": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"thumbnail": "<string>",
"created": "2023-11-07T05:31:56Z"
}
}