Get an API Product Version

Returns a version of an API product.

get

Path Parameters

apiProductIdstring(uuid)required

The API product identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

idstring(uuid)required

The API product version identifier

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

Response

application/json

API product

API Product Version

* Additional properties are NOT allowed.
idstring(uuid)requiredread-only

The API product version identifier.

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

namestringrequired

The version of the API product

Example:FirstVersion

gateway_serviceobject | nullrequired
* Additional properties are NOT allowed.
Show Child Parameters
publish_statusstringrequiredDEPRECATED

This field is published if the API product version is published to at least one portal. This field is deprecated: Use PortalProductVersion.publish_status instead.

Allowed values:unpublishedpublished

Example:unpublished

deprecatedbooleanrequiredDEPRECATED

Whether this API product version is deprecated in at least one portal. This field is deprecated: Use PortalProductVersion.deprecated instead

Example:false

labelsobjectrequired

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.

Example:{"env":"test"}

auth_strategy_sync_errorsarray | null[object]read-only

The set of errors encountered when trying to sync the auth strategies on the version

Example:{"plugin_name":"konnect-application-auth","value":"plugin_sync_error_comm","message":"Unable to connect to the control plane to update plugin"}

* Additional properties are NOT allowed.
Show Child Parameters
portalsarray[object]required

The list of portals which this API product version is configured for

>= 0 items

* Additional properties are NOT allowed.
Show Child Parameters
created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

get/api-products/{apiProductId}/product-versions/{id}
 
application/json

Update an API Product Version

Updates an API product version.

patch

Path Parameters

apiProductIdstring(uuid)required

The API product identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

idstring(uuid)required

The API product version identifier

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

Body

application/json

Update API Product Version Request

The request schema for updating a version of an API product.
Note that the publish_status and deprecated fields are deprecated: Use PortalProductVersion.publish_status instead.

* Additional properties are NOT allowed.
namestring

The version name of the API product version.

>= 1 characters

Example:v1

publish_statusstringDEPRECATED

The publish status of the API product version. Applies publish status to all related portal product versions. This field is deprecated: Use PortalProductVersion.publish_status instead.

Allowed values:unpublishedpublished

Example:unpublished

deprecatedbooleanDEPRECATED

Indicates if the version of the API product is deprecated. Applies deprecation or removes deprecation from all related portal product versions. This field is deprecated: Use PortalProductVersion.deprecated instead.

Example:false

notifyboolean

When set to true, and all the following conditions are true:

  • version of the API product deprecation has changed from false -> true
  • version of the API product is published

then consumers of the now deprecated verion of the API product will be notified.

Example:true

gateway_serviceAny Of
GatewayServicePayloadobject | null
* Additional properties are NOT allowed.
Show Child Parameters
labelsobject | null

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Labels are intended to store INTERNAL metadata.

Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.

Example:{"env":"test"}

Response

application/json

API product

API Product Version

* Additional properties are NOT allowed.
idstring(uuid)requiredread-only

The API product version identifier.

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

namestringrequired

The version of the API product

Example:FirstVersion

gateway_serviceobject | nullrequired
* Additional properties are NOT allowed.
Show Child Parameters
publish_statusstringrequiredDEPRECATED

This field is published if the API product version is published to at least one portal. This field is deprecated: Use PortalProductVersion.publish_status instead.

Allowed values:unpublishedpublished

Example:unpublished

deprecatedbooleanrequiredDEPRECATED

Whether this API product version is deprecated in at least one portal. This field is deprecated: Use PortalProductVersion.deprecated instead

Example:false

labelsobjectrequired

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.

Example:{"env":"test"}

auth_strategy_sync_errorsarray | null[object]read-only

The set of errors encountered when trying to sync the auth strategies on the version

Example:{"plugin_name":"konnect-application-auth","value":"plugin_sync_error_comm","message":"Unable to connect to the control plane to update plugin"}

* Additional properties are NOT allowed.
Show Child Parameters
portalsarray[object]required

The list of portals which this API product version is configured for

>= 0 items

* Additional properties are NOT allowed.
Show Child Parameters
created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

patch/api-products/{apiProductId}/product-versions/{id}

Body

{ "gateway_service": { "control_plane_id": "e4d9ebb1-26b4-426a-b00e-cb67044f3baf", "id": "09b4786a-3e48-4631-8f6b-62d1d8e1a7f3" } }
 
application/json

Delete API Product Version

Removes an API product version.

delete

Path Parameters

apiProductIdstring(uuid)required

The API product identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

idstring(uuid)required

The API product version identifier

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

Response

API product version was deleted successfully.

delete/api-products/{apiProductId}/product-versions/{id}
 

API Product Version Specification

Create API Product Version Specification

Creates a specification for a version of an API product.
Note: You can only have one specification for a product version.

post

Path Parameters

apiProductIdstring(uuid)required

The API product identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

apiProductVersionIdstring(uuid)required

The API product version identifier

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

Body

application/json

Create API Product Version Specification Request

The request schema to create a specification for a version of an API product.

* Additional properties are NOT allowed.
namestringrequired

The name of the API product version specification

Match pattern:^.+(?:\.yaml|\.yml|\.json)$

>= 1 characters<= 255 characters

Example:oas.yaml

contentstring(byte)required

The base64 encoded contents of the API product version specification

>= 1 characters

Example:TXkgWUFNTCBvciBKU09OIGZvcm1hdHRlZCBPQVMgY29udGVudA==

Response

application/json

API product version specification

API Product Version Spec

* Additional properties are NOT allowed.
idstring(uuid)requiredread-only

The API product version specification identifier.

Example:7710d5c4-d902-410b-992f-18b814155b53

namestringrequired

The name of the API product version specification

Match pattern:^.+(?:\.yaml|\.yml|\.json)$

Example:oas.yaml

contentstringrequired

The contents of the API product version specification

Example:My YAML or JSON formatted OAS content

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

post/api-products/{apiProductId}/product-versions/{apiProductVersionId}/specifications

Body

{ "name": "oas.yaml", "content": "TXkgWUFNTCBvciBKU09OIGZvcm1hdHRlZCBPQVMgY29udGVudA==" }
 
application/json