---
title: "Upload a company template"
method: POST
path: "/team/templates"
tags: ["team"]
---

# Upload a company template

`POST /team/templates`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/team/templates`
- Auth: HTTP bearer

Uploads a Word (.docx) template the company or its counsel wrote, for offer letters, CIIAAs, change letters, departure letters or separation agreements. Placeholders written {{employee_name}} from Binderwork's list are filled from records; other blanks are listed as not filled. A file with tracked changes, comments, macros, fields Word fills itself, external links or embedded objects is refused with the reason. The file is kept as uploaded; an admin confirms its first filled PDF before any letter uses it.

## Request body

- object
  - `kind` 'offer' | 'ciiaa' | 'change' | 'departure' | 'separation', required
  - `name` string
  - `file_name` string, required
  - `content_base64` string, base64, required
  - `license` string, required
  - `prepared_by` string, nullable
  - `signing` 'sign' | 'acknowledge'

## Response `200`

The result.

- object
  - `id` string, required
  - `kind` 'offer' | 'ciiaa' | 'change' | 'departure' | 'separation', required
  - `name` string, required
  - `file_name` string, required
  - `blanks` object[], required
    - `name` string, required
    - `source` string, required
  - `not_filled` string[], required
  - `license` string, required
  - `prepared_by` string, nullable, required
  - `signing` 'sign' | 'acknowledge', required
  - `uploaded_by` string, required
  - `uploaded_at` string, date-time, required
  - `confirmed` object, nullable, required
    - `by` string, required
    - `at` string, date-time, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

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