Nurama Developers
Assets

Remove the custom thumbnail from an asset

Soft-deletes every active `customThumbnailOriginal` and `customThumbnail` file on the asset by flipping their status to `inactive`, decrementing the asset's `sizeInBytes` and storage quota by the bytes that were active. Frontend rendering helpers (`getDisplayThumbnail`) automatically fall back to the auto-generated `thumbnail` files. Broadcasts an `assetFileUpdate` websocket event so connected clients re-render without a refetch.

DELETE
/assets/{assetId}/custom-thumbnail

Soft-deletes every active customThumbnailOriginal and customThumbnail file on the asset by flipping their status to inactive, decrementing the asset's sizeInBytes and storage quota by the bytes that were active. Frontend rendering helpers (getDisplayThumbnail) automatically fall back to the auto-generated thumbnail files. Broadcasts an assetFileUpdate websocket event so connected clients re-render without a refetch.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: assets:write

Path Parameters

assetId*string
Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/custom-thumbnail"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "ownerResourceId": "7d5ad1db-89f9-42df-868c-86a72347ae1c",  "ownerResourceType": "workspace",  "creatorId": "688ebf54-d343-4104-8711-82c2feac534a",  "creator": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "firstName": "string",    "lastName": "string",    "displayName": "string",    "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",    "color": "string",    "awards": [      "staff"    ],    "accountType": "standard"  },  "fileSystemPaths": [    "string"  ],  "basePath": "string",  "noFileSystem": false,  "keyPath": "string",  "checksum": "string",  "checksumAlgorithm": "sha256",  "contentSha256": "string",  "originalName": "string",  "originalExtension": "mov",  "originalSizeInBytes": 0,  "originalState": "stored",  "processingCompletedAt": 0,  "keepOriginal": true,  "pruneAfter": 0,  "pruneRequestedById": "106ef251-f0bc-45b7-8342-6f3d10dbd865",  "pruneReason": "manual",  "prunedAt": 0,  "reattachStartedAt": 0,  "reattachById": "250e32ee-9f86-4efa-94d3-2c18a10241d1",  "reattachUploadId": "string",  "pruneAttempts": 0,  "pruneError": "string",  "name": "string",  "slug": "string",  "functionType": "attachment",  "mediaType": "image",  "tags": [],  "files": [    {      "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",      "keyPath": "/project/asset/file123.jpg",      "checksum": "string",      "checksumAlgorithm": "md5",      "name": "string",      "functionType": "original",      "sizeInBytes": 0,      "status": "active",      "meta": {},      "createdAt": 1678886400000,      "updatedAt": 1678886400000    }  ],  "chats": {    "creatorLastMessageAt": "2019-08-24T14:15:22Z",    "reviewerLastMessageAt": "2019-08-24T14:15:22Z",    "creator": "1dccd4a6-75d2-43aa-a088-76d941f1b60a",    "reviewer": "a4b7b7a3-a1d0-4e27-9161-fa5679d1e0d6"  },  "expectedUploadSizeInMB": 0,  "sizeInBytes": 0,  "visibility": [    "creator"  ],  "publishedOn": 1678886400000,  "publisherId": "f1ba8124-cabe-46cd-b4f9-1189594ff7b3",  "publisher": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "firstName": "string",    "lastName": "string",    "displayName": "string",    "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",    "color": "string",    "awards": [      "staff"    ],    "accountType": "standard"  },  "hasActivePublicLink": false,  "hasActivePublicFileSystem": false,  "everPublic": false,  "publicFileSystemIds": [    "3a3392f6-5ad7-429c-8b57-759911bd1423"  ],  "publicAssetLinkIds": [    "35788e46-f1b0-471c-b8ec-69afab5a9e64"  ],  "submissionFileSystemIds": [    "c658ae43-33f0-4032-85f0-ea3242de6509"  ],  "aiGenerated": false,  "promotedFromAssetId": "c833ed16-de04-406f-a750-9ed1e24820b3",  "contentSnippet": "string",  "status": "active",  "meta": {},  "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46",  "inheritance": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6",    "resourceType": "string",    "inheritance": {      "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b": "workspace",      "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6c": "project"    },    "inheritanceInverted": {      "property1": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "property2": "497f6eca-6276-4993-bfeb-53cbbbba6f08"    },    "path": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "createdAt": 1678886400000,  "updatedAt": 1678886400000}