Changes the comment this file belongs to. | awork API

1 curl -X POST https://api.awork.com/api/v1/comments/commentId/files/fileId/changeentity \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "entityId": "123e4567-e89b-12d3-a456-426614174000", 6 "entityType": null 7 }'

1 { 2 "name": "Final project report", 3 "description": "The client requested a cost overview and timeline", 4 "id": "123e4567-e89b-12d3-a456-426614174000", 5 "entityId": "123e4567-e89b-12d3-a456-426614174000", 6 "fileName": "Final project report.xlsx", 7 "entityType": "project", 8 "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", 9 "createdOn": "createdOn", 10 "createdBy": "123e4567-e89b-12d3-a456-426614174000", 11 "updatedOn": "updatedOn", 12 "updatedBy": "123e4567-e89b-12d3-a456-426614174000", 13 "fileVersions": [ 14 { 15 "id": "123e4567-e89b-12d3-a456-426614174000", 16 "fileInfoId": "123e4567-e89b-12d3-a456-426614174000", 17 "version": 13, 18 "size": 13590, 19 "width": 1920, 20 "height": 1200, 21 "createdOn": "createdOn", 22 "createdBy": "123e4567-e89b-12d3-a456-426614174000", 23 "updatedOn": "updatedOn", 24 "updatedBy": "123e4567-e89b-12d3-a456-426614174000" 25 } 26 ], 27 "isCommentFile": false, 28 "externalProvider": null, 29 "externalFileUrl": null, 30 "isHiddenForConnectUsers": false 31 }

Changes the comment this file belongs to. Switch to the specified comment or to a global file if the 'EntityId' of the model is set to null.

Path parameters

commentIdUUIDRequired

The id of the comment.

fileIdUUIDRequired

The id of the file.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

entityIdUUID or nullOptional

The id of the entity the file should be linked to. Set to null to change the file to a global file.

entityTypestring or nullOptional

The type of the linked entity. Necessary if EntityId is set.

Response

namestring or nullOptional

The user-specified name of the file.

descriptionstring or nullOptional

The description of the file.

idUUIDOptional

The id of the file info.

entityIdUUID or nullOptional

The id of the linked entity.

fileNamestring or nullOptional

The name of the file.

entityTypestring or nullOptional

The name of the linked entity type.

mimeTypestring or nullOptional

The MIME type of the file.

createdOndatetimeOptional

The date this file was created.

createdByUUIDOptional

The id of the user who created this file.

updatedOndatetimeOptional

The date this file was last modified.

updatedByUUIDOptional

The id of the user who last modified this file.

fileVersionslist of objectsOptional

List of all versions.

isCommentFilebooleanOptional

Whether the file is related to a comment.

externalProviderstring or nullOptional

The external provider for the file. Like 'google' or 'onedrive'.

externalFileUrlstring or nullOptional

The file url of the external provider.

isHiddenForConnectUsersbooleanOptional

Whether the file is hidden for connect users.