Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.