---
title: "Create project template"
method: POST
path: "/project-templates"
tags: ["project-templates"]
---

# Create project template

`POST /project-templates`

## Request

- Base URL: `https://api.cogram.com/v1`
- URL: `https://api.cogram.com/v1/project-templates`
- Auth: HTTP bearer

Create a project template. Requires an org admin or owner key creator.

## Request body

- ProjectTemplateWriteV1: Create or replace a project template. Every field is written.
  - `name` string, required: Unique within the org (case-insensitive).
  - `description` string, nullable
  - `groups` ProjectTemplateGroupInV1[]
    - `group_id` string, required
    - `role` string, required: MEMBER, VIEWER, or LEAD.
  - `project_type_id` string, nullable
  - `email_filing_enabled_default` boolean
  - `is_public_default` boolean, nullable

## Response `201`

Successful Response

- ProjectTemplateV1: Project template with its group bindings.
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `groups` ProjectTemplateGroupV1[], required
    - `group_id` string, required
    - `group_name` string, required
    - `role` 'LEAD' | 'MEMBER' | 'VIEWER', required: Roles a group can hold on a project. OWNER stays direct-only by design; LEAD may be granted via a group (gated behind the project-lead-role flag at the assignment routes, like a direct LEAD).
    - `member_count` integer, required
  - `project_type_id` string, nullable, required
  - `email_filing_enabled_default` boolean, required
  - `is_public_default` boolean, nullable, required
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required: Null if never updated.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/cogram/apis/cogram-api.md) · [All operations](https://skmtc.dev/cogram/apis/cogram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cogram/apis/cogram-api/revisions/5a3c9c40fca5?raw)