For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeveloper ForumLogin
  • Overview
    • Introduction
    • Getting Started
    • Integration Example (PSA)
    • Authentication
    • Error Handling
    • Pagination
    • Filtering
    • Ordering
    • Rate Limits
    • Permissions
    • Webhooks
    • MCP Server
    • Versioning
    • Changelog
    • Support
  • API v1 Reference
    • Projects Overview
    • Tasks Overview
    • Time Tracking Overview
    • Documents Overview
    • Search Overview
    • Companies Overview
    • Users Overview
    • Files & Images Overview
      • POSTEndpoint to batch create external files without uploading.
      • GETReturns all files of the projecttemplate with the specified id.
      • POSTCreates a new projecttemplate file for the projecttemplate with the specified id..
      • DELDeletes the files of the specified projecttemplate.
      • POSTUploads a new file by providing an url.
      • GETReturns the file with the specified id of the projecttemplate with the specified id.
      • PUTUpdates the metadata of the projecttemplate file with the specified id.
      • DELDeletes the projecttemplate file with the specified id.
      • POSTChanges the projecttemplate this file belongs to.
      • POSTCopies the file to a new projecttemplate.
      • GETReturns the content of the file with the specified id as pdf. type or conversion not possible.
      • GETReturns an url to share the file.
      • GETReturns all file versions of the specified projecttemplate file.
      • POSTUploads a new version of the projecttemplate file with the specified id.
      • GETReturns the projecttemplate file version with the specified id.
      • GETReturns the content of the projecttemplate file version with the specified id.
    • Custom Fields Overview
    • Workload & Planning Overview
    • Project Templates Overview
    • Workflows Overview
    • Login & Access Overview
    • API Management Overview
LogoLogo
SupportDeveloper ForumLogin
API v1 ReferenceProject Template Files

Endpoint to batch create external files without uploading.

POST
https://api.awork.com/api/v1/projecttemplates/:projecttemplateId/externalfiles
POST
/api/v1/projecttemplates/:projecttemplateId/externalfiles
$curl -X POST https://api.awork.com/api/v1/projecttemplates/projecttemplateId/externalfiles \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '[
>  {
>    "name": "string",
>    "externalProvider": "string",
>    "externalFileUrl": "string"
>  }
>]'
200Successful
1{
2  "name": "Final project report",
3  "description": "The client requested a cost overview and timeline",
4  "id": "123e4567-e89b-12d3-a456-426614174000",
5  "projectId": "123e4567-e89b-12d3-a456-426614174000",
6  "projectTemplateId": "123e4567-e89b-12d3-a456-426614174000",
7  "companyId": "123e4567-e89b-12d3-a456-426614174000",
8  "taskId": "123e4567-e89b-12d3-a456-426614174000",
9  "taskTemplateId": "123e4567-e89b-12d3-a456-426614174000",
10  "userId": "123e4567-e89b-12d3-a456-426614174000",
11  "documentId": "123e4567-e89b-12d3-a456-426614174000",
12  "fileName": "Final project report.xlsx",
13  "entityType": "project",
14  "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
15  "createdOn": "2024-01-15T09:30:00Z",
16  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
17  "updatedOn": "2024-01-15T09:30:00Z",
18  "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
19  "fileVersions": [
20    {
21      "id": "123e4567-e89b-12d3-a456-426614174000",
22      "fileInfoId": "123e4567-e89b-12d3-a456-426614174000",
23      "version": 13,
24      "size": 13590,
25      "width": 1920,
26      "height": 1200,
27      "createdOn": "2024-01-15T09:30:00Z",
28      "createdBy": "123e4567-e89b-12d3-a456-426614174000",
29      "updatedOn": "2024-01-15T09:30:00Z",
30      "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
31    }
32  ],
33  "isCommentFile": false,
34  "externalProvider": null,
35  "externalFileUrl": null,
36  "isHiddenForConnectUsers": true,
37  "entityId": "123e4567-e89b-12d3-a456-426614174000"
38}
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>
Was this page helpful?
Previous

Returns all files of the projecttemplate with the specified id.

Next
Built with

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

Required Permissions
Any authenticated user.

Authentication

AuthorizationBearer

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

Path parameters

projecttemplateIdstringRequiredformat: "uuid"
The id of the projecttemplate.

Request

List of file forms.
namestringRequired>=1 character
The name of the file.
externalProviderstringRequired>=1 character
The external provider for the file. Like 'google' or 'onedrive'.
externalFileUrlstringRequired>=1 character
The file url of the external provider.
descriptionstring or nullOptional
The description of the file.
mimeTypestring or nullOptional
The mime type if the external file.

Response

OK
namestring or null

The user-specified name of the file.

descriptionstring or null
The description of the file.
idstringformat: "uuid"
The id of the file info.
projectIdstring or nullformat: "uuid"
projectTemplateIdstring or nullformat: "uuid"
companyIdstring or nullformat: "uuid"
taskIdstring or nullformat: "uuid"
taskTemplateIdstring or nullformat: "uuid"
userIdstring or nullformat: "uuid"
documentIdstring or nullformat: "uuid"
fileNamestring or null
The name of the file.
entityTypestring or null
The name of the linked entity type.
mimeTypestring or null
The MIME type of the file.
createdOnstringformat: "date-time"
The date this file was created.
createdBystringformat: "uuid"
The id of the user who created this file.
updatedOnstringformat: "date-time"
The date this file was last modified.
updatedBystringformat: "uuid"
The id of the user who last modified this file.
fileVersionslist of objects or null
List of all versions.
isCommentFileboolean
Whether the file is related to a comment.
externalProviderstring or null
The external provider for the file. Like 'google' or 'onedrive'.
externalFileUrlstring or null
The file url of the external provider.
isHiddenForConnectUsersboolean
Whether the file is hidden for connect users.
entityIdstring or nullformat: "uuid"Deprecated
Deprecated. The id of the linked entity derived from entity specific owner ids.