references list
List and filter references
paperpile-stage references list [flags]
| Flag | Description |
|---|---|
--api-key <value> |
Use this key for one command |
--library <value> |
Library to work in (default: your personal library) |
--query <value> |
Search terms; supports title:, author:, "phrases" and not: |
--folder <value> |
Folder id — filters a list, destination when saving; repeatable |
--label <value> |
Label id — filters a list, applied when saving; repeatable |
--type <value> |
Only references of this type; repeatable |
--starred |
Starred only when listing; sets starred when updating |
--has-pdf |
Only references with a primary PDF |
--trashed-mode <value> |
exclude (default), only, or include |
--sort <value> |
date_added, date_published, title, first_author, journal or relevance |
--order <value> |
asc or desc |
--limit <value> |
Results per page, 1-100 (default 50) |
--cursor <value> |
Cursor from a previous page |
--all |
Follow the cursor until every page is read |
--fields <value> |
Return only these fields; repeatable |
--expand <value> |
Replace ids with the objects they point at; repeatable |
Examples
# Search by author and phrase, newest first
paperpile-stage references list --query 'author:smith "deep learning"' --sort date_published --order desc
# Every starred reference with a PDF in one folder
paperpile-stage references list --folder <folder-id> --starred --has-pdf --all
