템플릿

템플릿 목록

GET/templates

키가 속한 워크스페이스에서 생성에 쓸 수 있는 저장된 템플릿을 최근 업데이트순으로 돌려줍니다. truncated가 true이면 페이지를 넘기지 말고 search로 좁히세요.

매개변수

이름	유형	설명
`search`	string	제목에 이 텍스트가 포함된 템플릿만.
`limit`	integer	페이지 크기, 1에서 200.

요청

curl "https://usepaperclerk.com/api/v1/templates?search=invoice" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

응답

JSON

{
  "workspace": "Acme Studio",
  "templates": [
    {
      "id": "4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f",
      "title": "Consulting invoice",
      "folder_path": "Finance / Invoices",
      "updated_at": "2026-09-10T09:14:03.201Z"
    }
  ],
  "total": 1,
  "truncated": false
}

workspace — 연결된 워크스페이스의 이름. 키 하나는 정확히 하나의 워크스페이스를 엽니다.
folder_path — 템플릿이 보관된 위치로, 상위 / 하위 형태입니다. 루트에 있으면 비어 있습니다.
total — limit과 무관하게 일치하는 템플릿 수.
truncated — total이 한 페이지를 넘으면 true.