...
On This Page
Table of Contents |
---|
...
Info |
---|
The CLI references “skysync.” This is expected. |
Job Categories
In the following examples, the authentication parameters are provided within the configuration file. See the authentication section for more information.
List Job Categories
parameter | description | required | default |
---|---|---|---|
search, q | Search text | optional | |
offset | Search offset | optional | 0 |
limit | Search page size | optional | 20 |
Example
Command
Code Block |
---|
skysync-cli job-categories list |
Example results
Code Block |
---|
ID Name
-1 Default
1 Maintenance |
Example results (JSON)
Code Block |
---|
[
{
"id": -1,
"name": "Default"
},
{
"id": 1,
"name": "Maintenance"
}
]
|
Show a Job Category
parameter | description | required |
---|---|---|
id | ID of the job category to be shown | required |
Example
In the following example, the authentication parameters are provided within the configuration file. See the authentication section for more information.
Command with variables
Code Block |
---|
skysync-cli job-categories show {{id}} |
Command with example values
Code Block |
---|
skysync-cli job-categories show 1 |
Example results
Code Block |
---|
ID 1
Name Maintenance |
Example results (JSON)
Code Block |
---|
[
{
"id": 1,
"name": "Maintenance"
}
]
|
Create a Job Category
parameter | description | type | option 1 | option 2 |
---|---|---|---|---|
name | Job category name | string | required |
Example with parameters
command with variables
Code Block |
---|
skysync-cli job-categories add {{name}} |
Command with example values
Code Block |
---|
skysync-cli job-categories add 'HR Department' |
Expected result
Code Block |
---|
ID 2
Name HR Deparment
|
Expected result (JSON)
Code Block |
---|
[
{
"id": 2,
"name": "HR Department"
}
]
|
Delete a Job Category
parameter | description | required |
---|---|---|
id | ID of the job category to be deleted | required |
Example
In the following example, the authentication parameters are provided within the configuration file. See the authentication section for more information.
Command with variables
Code Block |
---|
skysync-cli job-categories delete {{id}} |
Command with example values
Code Block |
---|
skysync-cli job-categories delete 2 |
Expected result
Code Block |
---|
The job category was deleted successfully. |
Error result
Code Block |
---|
The job category could not be deleted. |