...
On This Page
| Table of Contents |
|---|
...
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. |