projectTemplates

Creates a new project template.

Changed on

Creates a new project template. The new template supplies defaults for future projects.

<Check title="Required Permissions" icon="key">The user must be an admin or have project-manage-config:write permissions.</Check>

post/projecttemplates

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/projecttemplates
  • Auth: HTTP bearer

Request body

namestring nullable

Name of the project template.

descriptionstring nullable

Description of the project template.

isBillableByDefaultstring nullable

Whether the project should be billable by default. Can be 'on', 'off', or 'auto'. Default is auto.

defaultTaskListIdForEmailsstring uuid nullable
copyImageToProjectOnCreationboolean

Whether the template image should be copied to the project during project creation. If the template has no image, no image is copied. No image is copied from the client.

projectTypeIdstring uuid nullable

Project type id of the project template.

timeBudgetinteger nullable

The amount of time budgeted for the project in seconds. If null, the time budget will be unchanged. Set to 0 to remove the time budget.

Response

OK

idstring uuid

The id of the template.

namestring nullable

The name of the template.

descriptionstring nullable

The description that will be used for the project created from this template. It will be appended to the project description provided by the user.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

isBillableByDefaultstring nullable

Whether project times should be billable by default, if the project was created by this template. Can be 'on', 'off', or 'auto'.

defaultTaskListIdForEmailsstring uuid nullable

The id references the task list, which is used to assign tasks created by email to.

hasImageboolean

Whether the project template has an image in the files service.

copyImageToProjectOnCreationboolean

Whether the template image should be copied to the project during project creation. If the template has no image, no image is copied. No image is copied from the client.

projectTypeIdstring uuid nullable

The id of the project type.

workflowIdstring uuid nullable

The id of the workflow linked to this template.

timeBudgetinteger

The amount of time budgeted for the project in seconds.

hasRelativeTasksboolean

True if any of the tasks of the template has relative dates.

Changes

  • 84f37b3c4cbcRevision changes
    • info

      added the optional property // to the response with the status

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API