Sign in
userFiles

Endpoint to batch create external files without uploading.

Endpoint to create file infos with batch operation. Created file infos don't have a version.

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

post/users/{userId}/externalfiles

Path parameters

userIdstring uuid required

The id of the user.

Headers

Authorizationstring required

Bearer authentication

Request body

namestring required

The name of the file.

descriptionstring nullable

The description of the file.

externalProviderstring required

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

externalFileUrlstring required

The file url of the external provider.

mimeTypestring nullable

The mime type if the external file.

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

Changed in 1 of the 5 revisions of this API.31

  • a13e7c70426231See the full diff
    • ▲

      the items/externalFileUrl request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the items/externalProvider request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the items/name request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ○

      response property entityId deprecated

      response-property-deprecated