GET /katello/api/products
List products

GET /katello/api/subscriptions/:subscription_id/products
List of subscription products in a subscription

GET /katello/api/activation_keys/:activation_key_id/products
List of subscription products in an activation key

GET /katello/api/organizations/:organization_id/products
List of products in an organization

GET /katello/api/sync_plans/:sync_plan_id/products
List of Products for sync plan

GET /katello/api/organizations/:organization_id/sync_plans/:sync_plan_id/products
List of Products for sync plan

Params

Param Name Description
organization_id
Required

Filter products by organization

Validations:

  • number.

subscription_id
Optional

Filter products by subscription

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

name
Optional

Filter products by name

Validations:

  • String

enabled
Optional

Filter products by enabled or disabled

Validations:

  • boolean

custom
Optional

Filter products by custom

Validations:

  • boolean

include_available_content
Optional

Whether to include available content attribute in results

Validations:

  • boolean

sync_plan_id
Optional

Filter products by sync plan id

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

available_for
Optional

Interpret specified object to return only Products that can be associated with specified object. Only 'sync_plan' is supported.

Validations:

  • String

search
Optional

Search string

Validations:

  • String

page
Optional

Page number, starting at 1

Validations:

  • number.

per_page
Optional

Number of results per page to return

Validations:

  • number.

order
Optional

Sort field and order, eg. 'name DESC'

Validations:

  • String

full_results
Optional

Whether or not to show all results

Validations:

  • boolean

sort
Optional

Hash version of 'order' param

Validations:

  • Hash

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


POST /katello/api/products
Create a product

Params

Param Name Description
organization_id
Required

ID of the organization

Validations:

  • number.

description
Optional

Product description

Validations:

  • String

gpg_key_id
Optional

Identifier of the GPG key

Validations:

  • number.

sync_plan_id
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Plan numeric identifier

Validations:

  • number.

name
Required

Product name

Validations:

  • String

label
Optional

Validations:

  • String


GET /katello/api/products/:id
Show a product

Params

Param Name Description
id
Required

product numeric identifier

Validations:

  • number.


PUT /katello/api/products/:id
Updates a product

Params

Param Name Description
id
Required

product numeric identifier

Validations:

  • number.

description
Optional

Product description

Validations:

  • String

gpg_key_id
Optional

Identifier of the GPG key

Validations:

  • number.

sync_plan_id
Optional , <span class="translation_missing" title="translation missing: ca.apipie.nil_allowed">Nil Allowed</span>

Plan numeric identifier

Validations:

  • number.

name
Optional

Product name

Validations:

  • String


DELETE /katello/api/products/:id
Destroy a product

Params

Param Name Description
id
Optional

product numeric identifier

Validations:

  • number.


POST /katello/api/products/:id/sync
Sync all repositories for a product

Params

Param Name Description
id
Required

product ID

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..