On This Page
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
skysync-cli job-categories list
Example results
ID Name -1 Default 1 Maintenance
Example results (JSON)
[
{
"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
skysync-cli job-categories show {{id}}
Command with example values
skysync-cli job-categories show 1
Example results
ID 1 Name Maintenance
Example results (JSON)
[
{
"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
skysync-cli job-categories add {{name}}
Command with example values
skysync-cli job-categories add 'HR Department'
Expected result
ID 2 Name HR Deparment
Expected result (JSON)
[
{
"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
skysync-cli job-categories delete {{id}}
Command with example values
skysync-cli job-categories delete 2
Expected result
The job category was deleted successfully.
Error result
The job category could not be deleted.