문서

생성된 문서 목록

GET/generations

워크스페이스의 생성된 문서를 최신순으로 돌려줍니다. 필터는 AND로 결합됩니다.

매개변수

이름	유형	설명
`template`	uuid	이 템플릿에서 생성된 문서만.
`created_by`	uuid	이 사용자가 생성한 문서만.
`source`	app \| api	PaperClerk에서 생성된 문서는 app, API와 MCP 커넥터로 생성된 문서는 api.
`from`	date-time	이 시점 이후(포함)에 생성된 문서만. ISO 8601이며, 날짜만 쓰면 UTC 자정을 뜻합니다.
`to`	date-time	이 시점 이전에 생성된 문서만. 구간은 반개구간으로, from은 포함되고 to는 포함되지 않습니다.
`search`	string	제목에 이 텍스트가 포함된 문서만.
`limit`	integer	페이지 크기, 1에서 200.
`cursor`	string	이전 페이지의 next_cursor.

요청

curl "https://usepaperclerk.com/api/v1/generations?template=4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f&from=2026-09-01&limit=2" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

응답

JSON

{
  "generations": [
    {
      "id": "9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b",
      "template_id": "4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f",
      "template_title": "Consulting invoice",
      "title": "Invoice — Maple & Fern, September",
      "generation_number": 13,
      "source": "api",
      "source_version": 3,
      "created_by": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
      "created_by_name": "Mara Novak",
      "created_at": "2026-09-12T14:02:11.480Z",
      "pdf_status": "ready",
      "pdf_url": "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf",
      "url": "https://usepaperclerk.com/app/generated/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b"
    },
    { "…": "…" }
  ],
  "total": 27,
  "has_more": true,
  "next_cursor": "MjAyNi0wOS0xMlQxNDowMDowNS4wMDBafDliOGUyZjEw…"
}

템플릿이 삭제되면 template_id는 null이 되지만 문서와 template_title은 남습니다.
템플릿 안에서의 문서 번호. source_version은 생성에 사용된 저장 버전입니다.
마지막 페이지에서는 next_cursor가 null입니다.
total은 페이지 크기와 관계없이 필터에 맞는 모든 문서를 셉니다.
created_by_name은 사용자의 표시 이름이며, 워크스페이스가 더 이상 공유하지 않으면 null입니다.