---
title: "Get canonical email template for a use case"
method: GET
path: "/v2/projects/email-template"
tags: ["Projects"]
---

# Get canonical email template for a use case

`GET /v2/projects/email-template`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/projects/email-template`
- Auth: HTTP bearer

Returns the canonical `default_instructions` and every system email template registered for a `use_case` (e.g. intro_request, sales, recruiting). Copy these verbatim when drafting sequence steps for `submit_plan`. Part of the project-planning flow — the `plan_a_project` prompt orchestrates create_project → get_planner_skills → get_email_template → submit_plan; start there when the user wants to run outreach.

## Query parameters

- `use_case` string, required: Use case key (e.g. intro_request, sales, recruiting). Matches the project_type / use_case in the canonical templates.

## Response `200`

Canonical email instructions and templates

- object
  - `data` EmailTemplateResponse, required: Canonical email instructions and templates for a use_case.
    - `use_case` string, required
    - `name` string, required
    - `description` string, required
    - `default_instructions` string, required
    - `templates` object[], required
      - `name` string, required
      - `used_for` string, required
      - `subject` string, required
      - `email_body` string, required
      - `audience` 'warm' | 'cold_referral' | 'cold', nullable, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Use case not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)