https://github.com/formspree/zdesk
A command line tool for performing bulk operations on Zendesk support tickets
https://github.com/formspree/zdesk
Last synced: 11 months ago
JSON representation
A command line tool for performing bulk operations on Zendesk support tickets
- Host: GitHub
- URL: https://github.com/formspree/zdesk
- Owner: formspree
- License: mit
- Created: 2019-01-07T01:18:55.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T09:47:47.000Z (over 3 years ago)
- Last Synced: 2025-06-14T07:53:42.725Z (12 months ago)
- Language: JavaScript
- Size: 88.9 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zdesk
A command line tool for performing bulk operations on Zendesk support tickets
## install
```
npm install -g zdesk
```
## Usage
```
Usage: zdesk [options] [command]
Zendesk support ticket bulk operations
Options:
-V, --version output the version number
-h, --help output usage information
Commands:
login [options] Login with your email and API Key. Stored in the OS Keychain or equivalent.
logout Remove your Zendesk API keys from the OS Keychain or equivalent.
list|ls [options] [moreTerms...] List tickets using a search string
delete|del [options] [moreTerms...] Delete all tickets that match a search string
```
## Authentication
The `login` command uses [keytar](https://www.npmjs.com/package/keytar) to store your credentials in the OS Keychain or
equivalent. Login will prompt you for your site id, username and API key, or if
you run one of the other commands without credentials configured, you will first
be prompted to login.
To create an API key see the [Zendesk helpsite](https://support.zendesk.com/hc/en-us/articles/226022787-Generating-a-new-API-token-).
Running the `logout` command will remove the credentials.
Example:
```
$ zdesk login
? Enter your Zendesk organization id (???.zendesk.com): example
? Enter your Zendesk email: user@example.com
? Enter your API key: [hidden]
```
## List
```
Usage: list|ls [options] [moreTerms...]
List tickets using a search string
Options:
-n --num The number of results to return, default is 100
-v --verbose Output some debug logs
-h, --help output usage information
```
List all tickets that match the search terms. For example:
```
$ zdesk ls confirmation question -n 3
0 | Jun 6, 2018 8:12 PM | Robot Verify and Email Confirmation
1 | Oct 8, 2018 10:24 AM | Question
2 | Dec 19, 2017 5:33 PM | questionable confirmation email
Total: 3 items
```
## Delete
```
Usage: delete|del [options] [moreTerms...]
Delete all tickets that match a search string
Options:
-n --num The number of results to return, default is 100
-v --verbose Output some debug logs
-h, --help output usage information
```
Delete all tickets that match the search terms. For example:
```
$ zdesk del confirmation question -n 3
Deleted 3 tickets
```