GET /katello/api/sync_plans
List sync plans

GET /katello/api/organizations/:organization_id/sync_plans

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.

name
optional

filter by name

Validations:

  • String

sync_date
optional

filter by sync date

Validations:

  • String

interval
optional

filter by interval

Validations:

  • Must be one of: hourly, daily, weekly, custom cron.

search
optional

Search string

Validations:

  • String

page
optional

Page number, starting at 1

Validations:

  • Must be a number.

per_page
optional

Number of results per page to return

Validations:

  • Must be a number.

order
optional

Sort field and order, eg. ‘id DESC’

Validations:

  • String

full_result
optional

Whether or not to show all results

Validations:

  • Must be one of: true, false, 1, 0.

sort_by
optional

Field to sort the results on

Validations:

  • String

sort_order
optional

How to order the sorted results (e.g. ASC for ascending)

Validations:

  • String

Search fields

Field name Type Possible values
enabled true, false
interval string
name string
organization_id integer

GET /katello/api/organizations/:organization_id/sync_plans/:id
Show a sync plan

GET /katello/api/sync_plans/:id
Show a sync plan

Params

Param name Description
organization_id
optional

Organization ID

Validations:

  • Must be a number.

id
required

sync plan numeric identifier

Validations:

  • Must be a number.


POST /katello/api/organizations/:organization_id/sync_plans
Create a sync plan

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.

name
required

sync plan name

Validations:

  • String

interval
required

how often synchronization should run

Validations:

  • Must be one of: hourly, daily, weekly, custom cron.

sync_date
required

start datetime of synchronization

Validations:

  • String

description
optional

sync plan description

Validations:

  • String

enabled
required

enables or disables synchronization

Validations:

  • Must be one of: true, false, 1, 0.

cron_expression
optional

Add custom cron logic for sync plan

Validations:

  • String


PUT /katello/api/organizations/:organization_id/sync_plans/:id
Update a sync plan

PUT /katello/api/sync_plans/:id
Update a sync plan

Params

Param name Description
organization_id
optional

Organization ID

Validations:

  • Must be a number.

id
required

sync plan numeric identifier

Validations:

  • Must be a number.

name
optional

sync plan name

Validations:

  • String

interval
optional

how often synchronization should run

Validations:

  • Must be one of: hourly, daily, weekly, custom cron.

sync_date
optional

start datetime of synchronization

Validations:

  • String

description
optional

sync plan description

Validations:

  • String

enabled
optional

enables or disables synchronization

Validations:

  • Must be one of: true, false, 1, 0.

cron_expression
optional

Add custom cron logic for sync plan

Validations:

  • String


DELETE /katello/api/organizations/:organization_id/sync_plans/:id
Destroy a sync plan

DELETE /katello/api/sync_plans/:id
Destroy a sync plan

Params

Param name Description
organization_id
optional

Organization ID

Validations:

  • Must be a number.

id
optional

sync plan numeric identifier

Validations:

  • Must be a number.


PUT /katello/api/organizations/:organization_id/sync_plans/:id/add_products
Add products to sync plan

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.

id
required

ID of the sync plan

Validations:

  • String

product_ids
required

List of product ids to add to the sync plan

Validations:

  • Must be an array of any type


PUT /katello/api/organizations/:organization_id/sync_plans/:id/remove_products
Remove products from sync plan

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.

id
required

ID of the sync plan

Validations:

  • String

product_ids
required

List of product ids to remove from the sync plan

Validations:

  • Must be an array of any type


PUT /katello/api/sync_plans/:id/sync
Initiate a sync of the products attached to the sync plan

PUT /katello/api/organizations/:organization_id/sync_plans/:id/sync
Initiate a sync of the products attached to the sync plan

Params

Param name Description
id
required

ID of the sync plan

Validations:

  • String