Nurama Developers
Assets

Promote a chat-message attachment to a project asset

Copies a chat-message attachment (an asset with `ownerResourceType: 'chat'` and `functionType: 'attachment'`) into the destination project as a new, fully independent project asset. Deleting either side afterwards has no effect on the other. Permission is `canCreateAsset` on the destination project (`body.projectId`), which excludes reviewers. The source chat must live in the same workspace as the destination project. Idempotent: promoting the same source into the same project again returns the existing promoted asset with `deduped: true`. When post-processing is required the new asset is returned before it is `active`; the usual asset activation notifications fire when processing completes.

POST
/assets/{assetId}/promote-to-project

Copies a chat-message attachment (an asset with ownerResourceType: 'chat' and functionType: 'attachment') into the destination project as a new, fully independent project asset. Deleting either side afterwards has no effect on the other.

Permission is canCreateAsset on the destination project (body.projectId), which excludes reviewers. The source chat must live in the same workspace as the destination project.

Idempotent: promoting the same source into the same project again returns the existing promoted asset with deduped: true. When post-processing is required the new asset is returned before it is active; the usual asset activation notifications fire when processing completes.

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

ID of the chat-message attachment asset to promote.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/promote-to-project" \  -H "Content-Type: application/json" \  -d '{    "projectId": "0193e4a1-b2c3-7000-8000-000000000001",    "fileName": "brief-v2.pdf"  }'
{  "asset": {    "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  },  "deduped": true}