taskFiles

Changes the task that owns the specified file.

Changed on

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

post/tasks/{taskId}/files/{fileId}/changeentity

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/tasks/{taskId}/files/{fileId}/changeentity
  • Auth: HTTP bearer

Path parameters

taskIdstring uuid required
fileIdstring uuid required

Request body

entityIdstring uuid nullable

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

entityTypestring nullable

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

Response

OK

namestring nullable

The user-specified name of the file.

descriptionstring nullable

The description of the file.

idstring uuid

The id of the file info.

entityIdstring uuid nullable

Deprecated. The id of the linked entity derived from entity specific owner ids.

projectIdstring uuid nullable
projectTemplateIdstring uuid nullable
companyIdstring uuid nullable
taskIdstring uuid nullable
taskTemplateIdstring uuid nullable
userIdstring uuid nullable
documentIdstring uuid nullable
fileNamestring nullable

The name of the file.

entityTypestring nullable

The name of the linked entity type.

mimeTypestring nullable

The MIME type of the file.

createdOnstring date-time

The date this file was created.

createdBystring uuid

The id of the user who created this file.

updatedOnstring date-time

The date this file was last modified.

updatedBystring uuid

The id of the user who last modified this file.

isCommentFileboolean

Whether the file is related to a comment.

externalProviderstring nullable

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

externalFileUrlstring nullable

The file url of the external provider.

isHiddenForConnectUsersboolean

Whether the file is hidden for connect users.

Changes

  • 5332322ffca3Revision changes
    • info

      api operation id taskFiles_ChangeTask removed and replaced with taskFiles_PostFilesChangeTaskByTaskNameAndTaskIdAndFileId

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API