Get an API spec
Returns the API spec for the given service.
Path Parameters
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Response
application/json
Response
A response containing a single API spec.
CatalogServiceApiSpec
The API spec ID
Example:eadb88fe-e8eb-45c2-9591-dc783f93f29b
The ID of the service the API spec is associated to.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The name of the API
>= 1 characters<= 120 characters
Example:Pet Store
The description of the API.
<= 2048 characters
Example:A sample API that uses a pet store as an example to demonstrate features in the OpenAPI specification.
The ID of the Resource that is bound to the API spec.
Only set when the given provider.type requires a 1-to-1 mapping between Resource
and API Spec.
Example:IqkHvMdyHukxcwAs
Any OfRepresents the provider, or source, of API spec contents.
Show Child Parameters
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
Authentication
Path Parameters
Update API Spec
Updates the API spec for the given service.
Path Parameters
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Body
application/json
Body
UpdateCatalogServiceApiSpec
The name of the API
>= 1 characters<= 120 characters
Example:Pet Store
The description of the API
<= 2048 characters
Example:A sample API that uses a pet store as an example to demonstrate features in the OpenAPI specification
One OfRepresents the provider, or source, of an API specs.
Note that provider cannot be patched for API specs that are bound to a resource.
Trying to do so will result in a 400 response.
Show Child Parameters
Response
application/json
Response
A response containing a single API spec.
CatalogServiceApiSpec
The API spec ID
Example:eadb88fe-e8eb-45c2-9591-dc783f93f29b
The ID of the service the API spec is associated to.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The name of the API
>= 1 characters<= 120 characters
Example:Pet Store
The description of the API.
<= 2048 characters
Example:A sample API that uses a pet store as an example to demonstrate features in the OpenAPI specification.
The ID of the Resource that is bound to the API spec.
Only set when the given provider.type requires a 1-to-1 mapping between Resource
and API Spec.
Example:IqkHvMdyHukxcwAs
Any OfRepresents the provider, or source, of API spec contents.
Show Child Parameters
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
Authentication
Path Parameters
Body
Delete API Spec
Deletes the API spec for the given service.
Path Parameters
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Response
Response
API Spec was deleted successfully.
Authentication
Path Parameters
Get an API Spec Contents
Returns the API spec for the given service.
Specify Accept: application/json to retrieve the contents as JSON.
Specify Accept: application/yaml to retrieve the contents as YAML.
Defaults to JSON format.
Path Parameters
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
The id of the service.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Response
Response
Response object containing raw API spec contents
ApiSpecContents
Represents raw API spec contents
Authentication
Path Parameters
Catalog Integrations
Integrations are applications, either Konnect-internal or external, which extend the functionality of the Service Catalog.
Install and authorize an integration to discover the resources across your organization which support your services.
Map relevant resources to your services to provide a rich view of cataloged services.
To set up and view a list of all the integrations we support please view our documentation.