Konnect Service Catalog

List Integration Events

Returns a paginated collection of integration events.

get

Query Parameters

pageobject

Determines which page of the collection to retrieve.

Show Child Parameters
filterobject

Filters a collection of integration events.

* Additional properties are NOT allowed.
sortstring

The asc suffix is optional as the default sort order is ascending.
The desc suffix is used to specify a descending order.
Multiple sort attributes may be provided via a comma separated list.
JSONPath notation may be used to specify a sub-attribute (eg: ‘foo.bar desc’).

Example:created_at desc

Response

application/json

A Paginated list response for a collection of integration events.

* Additional properties are NOT allowed.
metaobjectrequired

Pagination metadata.

Show Child Parameters
dataarray[object]required

Event on a resource binding for an integration.

* Additional properties are NOT allowed.
Show Child Parameters
get/integration-events
 
application/json

Bulk Create Integration Events

Bulk-creates integration events for an integration.

post

Path Parameters

integrationInstancestringrequired

Machine name of the integration.

Example:gateway-manager

Body

application/json

Request body schema for bulk-creating integration events.

* Additional properties are NOT allowed.
dataarray[object]required

DTO object for creating an integration event for an integration. type and binding are parameters restricted by the
integration the event is being created for, found in the related integration manifest.

* Additional properties are NOT allowed.
Show Child Parameters

Response

The payload for bulk integration event create was accepted.

post/integration-instances/{integrationInstance}/integration-events

Body

{ "data": [ { "type": "incident.triggered", "ts": "2024-01-01T00:00:00Z", "deduplication_id": "1d34191ebfe305a56bf4f3303d1a8dcf", "actor": { "type": "user", "id": "PLH1HKV" }, "attributes": { "service_id": "PLK33TY", "incident_id": "PGR0VU2", "escalation_policy_id": "P005NFS", "priority_id": "P9BO35Z", "urgency": "low", "title": "Example API Service Incident", "html_url": "https://acme.pagerduty.com/incidents/PGR0VU2" }, "data": { "pagerduty_service_id": "PLK33TY" }, "binding": "pagerduty_service", "detail": "Example API Service Incident", "link_html": "https://acme.pagerduty.com/incidents/PGR0VU2" } ] }
 

List a catalog service integration Events

Returns a paginated collection of integration events belonging to the given catalog service.

get

Query Parameters

pageobject

Determines which page of the collection to retrieve.

Show Child Parameters
filterobject

Filters a collection of events for a given service.

* Additional properties are NOT allowed.
sortstring

The asc suffix is optional as the default sort order is ascending.
The desc suffix is used to specify a descending order.
Multiple sort attributes may be provided via a comma separated list.
JSONPath notation may be used to specify a sub-attribute (eg: ‘foo.bar desc’).

Example:created_at desc

Path Parameters

serviceIdstring(uuid)required

ID of the service.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

Response

application/json

A Paginated list response for a collection of integration events.

* Additional properties are NOT allowed.
metaobjectrequired

Pagination metadata.

Show Child Parameters
dataarray[object]required

Event on a resource binding for an integration.

* Additional properties are NOT allowed.
Show Child Parameters
get/catalog-services/{serviceId}/integration-events
 
application/json

Catalog Service Documents

Attach documentation for your services to communicate it’s architecture, support details, release notes, and usage examples, to help others understand and integrate with the service.

Create Service Document

Creates a service document

post

Path Parameters

serviceIdstringrequired

The id of the service.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

Body

application/json

CreateServiceDocumentPayload

* Additional properties are NOT allowed.
slugstringrequired

document slug

Match pattern:^[\w\/-]+$

<= 512 characters

Example:path-for-seo

titlestringrequired

Document title

parent_document_idstring | null(uuid)

parent document id

Example:dd4e1b98-3629-4dd3-acc0-759a726ffee2

contentstringrequired

Markdown content.

Response

application/json

Response object for fetching a single service document

ServiceDocumentContentResponse

* Additional properties are NOT allowed.
slugstringrequired

document slug

Match pattern:^[\w\/-]+$

<= 512 characters

Example:path-for-seo

titlestringrequired

Document title

parent_document_idstring | null(uuid)required

parent document id

Example:dd4e1b98-3629-4dd3-acc0-759a726ffee2

contentstringrequired

Markdown content.

idstring(uuid)required

The service document identifier.

Example:de5c9818-be5c-42e6-b514-e3d4bc30ddeb

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/catalog-services/{serviceId}/documents

Body

{ "slug": "readme", "title": "README", "content": "My Documentation" }
 
application/json