문서

문서 생성

POST/templates/{id}/generations

변경 불가 문서를 만듭니다. 템플릿의 저장된 버전에 values를 적용한 것입니다. Markdown, 페이지 URL, PDF 상태를 포함한 문서를 201로 돌려줍니다. 문서가 존재하는 순간 저희 서버에서 PDF 렌더링이 시작되며, 보통 몇 초 안에 준비됩니다.

매개변수

이름	유형	설명
`id`필수	uuid	템플릿의 ID.
`values`	object	플레이스홀더 키에는 값, 그룹 키에는 인스턴스 객체 배열. 플레이스홀더 채우기를 참고하세요.
`title`	string	문서의 이름. 기본값: 템플릿 제목 뒤에 번호.

요청

curl -X POST https://usepaperclerk.com/api/v1/templates/4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f/generations \
  -H "Authorization: Bearer pc_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Invoice — Maple & Fern, September",
    "values": {
      "client_name": "Maple & Fern Ltd.",
      "payment_terms": "Net 15",
      "due_date": "10/15/2026",
      "line_items": [
        { "item": "Brand identity system", "quantity": "1", "amount": "4800" },
        { "item": "Brand guidelines document", "quantity": "1", "amount": "1200" }
      ]
    }
  }'

응답

JSON

HTTP/1.1 201 Created
Location: https://usepaperclerk.com/app/generated/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b

{
  "id": "9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b",
  "template_id": "4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f",
  "title": "Invoice — Maple & Fern, September",
  "generation_number": 13,
  "source": "api",
  "source_version": 3,
  "created_at": "2026-09-12T14:02:11.480Z",
  "markdown": "# Invoice — Maple & Fern, September\n\nInvoice INV-0013 for Maple & Fern Ltd. …",
  "html": "<div class=\"doc-page\" …>…</div>",
  "html_truncated": false,
  "url": "https://usepaperclerk.com/app/generated/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b",
  "pdf_status": "pending",
  "pdf_url": "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf"
}

Location 헤더에 문서 페이지의 URL이 실립니다.
같은 요청이 10분 안에 다시 도착하면, 이미 생성된 문서를 201 대신 HTTP 200과 replayed: true로 돌려줍니다.
pdf_status는 pending으로 시작해 렌더링이 끝나면 ready가 됩니다. pdf_url은 아래의 PDF 엔드포인트입니다.