Project Task Templates API

List project task templates
Get a single project task template
Create a project task template
Update a project task template
Fields

List project task templates

List all project task templates for an account:

GET /project_task_templates

Response

Status: 200 OK

[
  {
    "id": 1034,
    "sourceID": null,
    "subject": "Finalize project implementation plan",
    "category": "activity",
    "created_at": "2016-12-23T05:09:04-06:00",
    "updated_at": "2016-12-23T05:09:04-06:00"
  },
  {
    "id": 805,
    "sourceID": null,
    "subject": "Approval from steering committee",
    "category": "approval",
    "created_at": "2016-12-23T05:09:04-06:00",
    "updated_at": "2016-12-23T05:09:04-06:00"
  },
  {
    "id": 371,
    "sourceID": null,
    "subject": "Project completed",
    "category": "milestone",
    "created_at": "2016-12-23T05:09:05-06:00",
    "updated_at": "2016-12-23T05:09:05-06:00"
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of project task templates.

Predefined Filters

The following predefined filters are available:

/project_task_templates/disabled : List all disabled project task templates
/project_task_templates/enabled : List all enabled project task templates

Collection Fields

By default the following fields will appear in collections of project task templates:

id sourceID subject impact category created_at updated_at

Obtain a different set of fields using the ?fields= parameter .

Filtering

Filtering is available for the following fields :

id source sourceID subject disabled category created_at updated_at

Sorting

By default a collection of project task templates is sorted descending by id .

The following fields are accepted by the ?sort= parameter :

id sourceID subject category created_at updated_at times_applied

Get a single project task template

GET /project_task_templates/:id

Response

Status: 200 OK

{
  "assign_to_project_manager": true,
  "assign_to_requester": false,
  "assign_to_requester_business_unit_manager": false,
  "assign_to_requester_manager": false,
  "assign_to_service_owner": false,
  "planned_effort_project_manager": 240,
  "planned_effort_requester": null,
  "planned_effort_requester_business_unit_manager": null,
  "planned_effort_requester_manager": null,
  "planned_effort_service_owner": null,
  "attachments": [],
  "category": "activity",
  "copy_notes_to_project": false,
  "created_at": "2016-12-23T05:09:04-06:00",
  "disabled": false,
  "effort_class": null,
  "id": 1034,
  "instructions": "Be sure to include a communication plan that will keep everyone informed.",
  "note": null,
  "planned_duration": 1440,
  "required_approvals": null,
  "source": null,
  "sourceID": null,
  "subject": "Finalize project implementation plan",
  "supplier": null,
  "times_applied": 28,
  "ui_extension": null,
  "updated_at": "2016-12-23T05:09:04-06:00"
}

The response contains these fields .

Create a project task template

POST /project_task_templates

When creating a new project task template these fields are available.

Response

Status: 201 Created

{
  "assign_to_project_manager": "...",
  "...": "..."
}

The response contains all fields of the created project task template and is similar to the response in Get a single project task template

Update a project task template

PATCH /project_task_templates/:id

When updating a project task template these fields are available.

Response

Status: 200 OK

{
  "assign_to_project_manager": "...",
  "...": "..."
}

The response contains all fields of the updated project task template and is similar to the response in Get a single project task template

Fields

assign_to_project_manager

Optional boolean , default: false — The Project manager box is checked if the project manager is to be selected in the Assignees field of a new project task when it is being created based on the template.

assign_to_requester

Optional boolean , default: false — The Requester box is checked if a new project task that is being created based on the template is to be assigned to the person who is selected in the Requested for field of the request for which the project was registered.

assign_to_requester_business_unit_manager

Optional boolean , default: false — The Requester’s business unit manager box is checked if a new project task that is being created based on the template is to be assigned to the person who is selected in the Manager field of the business unit to which the organization belongs that is linked to the person who is selected in the Requested for field of the request for which the project was registered.

assign_to_requester_manager

Optional boolean , default: false — The Requester’s manager box is checked if a new project task that is being created based on the template is to be assigned to the manager of the project’s requester.

assign_to_service_owner

Optional boolean , default: false — The Service owner box is checked if a new project task that is being created based on the template is to be assigned to the person who is selected in the Service owner field of the service that is linked to the project that the new project task is a part of.

attachments

Readonly aggregated Attachments