テンプレート

テンプレートの一覧

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 — 接続されたワークスペースの名前。1つのキーはちょうど1つのワークスペースを開きます。
folder_path — テンプレートの保管場所。親 / 子の形式で、ルートにある場合は空です。
total — limit にかかわらず、一致するテンプレートの数。
truncated — total がページを超えると true。