# Creating a new Project Template

This endpoint returns structured Project Template objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the project_templates top-level JSON key.
Please see our Response Format section for more information.

Endpoint: POST /project_templates
Version: 1.0.0

## Query parameters:

  - `include` (string)
    Any of the below associations can be included in your request by providing the include param, e.g. include=association1,association2.
- project_template_additional_tabs (ProjectTemplateAdditionalTab) - Retrieves the additional tabs added to the template. The response will include project_template_additional_tab_ids, which references the data in the project_template_additional_tabs top-level key.
- project_template_assignments (ProjectTemplateAssignment) - Project template assignments associated with the project template.
- user (User) - The user who created the project template (referenced by user_id).

  - `optional_fields` (array)
    Allows you to request one or more optional fields as an array.
    Enum: "raw_json"

## Request fields (application/json):

  - `project_template` (object)

  - `project_template.title` (string, required)
    The title of the project template.

  - `project_template.currency` (string, required)
    The currency of the project template.

  - `project_template.sharing` (string)
    The sharing setting for the template. Viewable and editable templates can be seen by users on the account other than the creator.
    Enum: "private_template", "viewable_template", "editable_template"

  - `project_template.is_budgeted` (boolean)
    The project template has financial attributes including overall budget, task budgets, and task time estimates.

  - `project_template.budget` (integer)
    The estimated overall budget of the project associated with the template.

  - `project_template.duration` (integer)
    The estimated number of days that the associated project will take.

  - `project_template.description` (string)
    A description of the project template which does not carry over to the project description when applied.

  - `project_template.raw_json` (string)
    A JSON hash that contains all project templates' tasks.

## Response 200 fields (application/json):

  - `count` (integer)

  - `meta` (object)

  - `meta.count` (integer)

  - `meta.page_count` (integer)

  - `meta.page_number` (integer)

  - `meta.page_size` (integer)

  - `results` (array)

  - `results.key` (string)

  - `results.id` (string)

  - `project_templates` (object)

  - `users` (object)

  - `project_template_assignments` (object)

  - `project_template_additional_tabs` (object)

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)

## Response 403 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)

## Response 422 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)

## Response 503 fields (application/json):

  - `errors` (array)

  - `errors.type` (string)

  - `errors.message` (string)