idstringrequired
The id of the integration instance.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
Fetch Integration Instance
Fetches a integration instance.
get
Path Parameters
Response
200 application/json
Response
200 application/json
A response containing a single integration instance object.
IntegrationInstance
Information about an integration instance.
idstring(uuid)requiredread-only
The integration instance ID.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
namestringrequired
The machine name of the integration instance that uniquely identifies it within the catalog.
Match pattern:^[0-9a-z.-]+$
>= 1 characters<= 120 characters
Example:aws-lambda-prod
display_namestringrequired
The display name of the integration instance.
>= 1 characters<= 120 characters
Example:AWS (prod)
descriptionstring | nullrequired
The description of the integration instance.
<= 2048 characters
integrationobjectrequired
Short-hand descriptor of an integration that omits instance metadata.
Show Child Parameters
authorizedbooleanrequiredread-only
Denotes whether the integration instance has been authorized within the catalog.
Example:true
configobjectrequired
JSON object representing configuration specific to the integration instance.
The expected schema depends on the integration type and is dynamically registered at runtime.
Default:{}
Example:{"account_region":"eu"}
* Additional properties are allowed.
get/integration-instances/{id}
Path Parameters
200 application/json
Update Integration Instance
Updates an integration instance.
patch
Path Parameters
idstringrequired
The id of the integration instance.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
Body
application/json
Body
application/json
UpdateIntegrationInstance
* Additional properties are NOT allowed.
namestring
The machine name of the integration instance that uniquely identifies it within the catalog.
Match pattern:^[0-9a-z.-]+$
>= 1 characters<= 120 characters
Example:aws-lambda-prod
display_namestring
The display name of the integration instance.
>= 1 characters<= 120 characters
Example:AWS (prod)
descriptionstring | null
Optionally provide a description of the integration instance.
<= 2048 characters
configobject
JSON object representing configuration specific to the integration instance.
The expected schema depends on the integration type and is dynamically registered at runtime.
Default:{}
Example:{"account_region":"eu"}
* Additional properties are allowed.
Response
200 application/json
Response
200 application/json
A response containing a single integration instance object.
IntegrationInstance
Information about an integration instance.
idstring(uuid)requiredread-only
The integration instance ID.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
namestringrequired
The machine name of the integration instance that uniquely identifies it within the catalog.
Match pattern:^[0-9a-z.-]+$
>= 1 characters<= 120 characters
Example:aws-lambda-prod
display_namestringrequired
The display name of the integration instance.
>= 1 characters<= 120 characters
Example:AWS (prod)
descriptionstring | nullrequired
The description of the integration instance.
<= 2048 characters
integrationobjectrequired
Short-hand descriptor of an integration that omits instance metadata.
Show Child Parameters
authorizedbooleanrequiredread-only
Denotes whether the integration instance has been authorized within the catalog.
Example:true
configobjectrequired
JSON object representing configuration specific to the integration instance.
The expected schema depends on the integration type and is dynamically registered at runtime.
Default:{}
Example:{"account_region":"eu"}
* Additional properties are allowed.
patch/integration-instances/{id}
Path Parameters
Body
{}
200 application/json
Delete Integration Instance
Deletes an integration instance.
delete
Path Parameters
idstringrequired
The id of the integration instance.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
Response
204
Response
204
Integration Instance was deleted successfully.
delete/integration-instances/{id}
Path Parameters
204
Integration Instance Auth Credentials
Create Integration Instance Auth Credential
Creates an auth credential scoped to the given integration instance.
Auth credentials are singleton resources that have a 1-to-1 relationship with
an integration instance.
An attempt to create subsequent auth credentials for an instance will result in a 409 response.
post
Path Parameters
idstringrequired
The id of the integration instance.
Example:3f51fa25-310a-421d-bd1a-007f859021a3
Body
application/json
Body
application/json
CreateIntegrationInstanceAuthCredential
CreateIntegrationInstanceAuthCredential
One Oftypestringrequired
Allowed values:oauth
configobjectrequired
* Additional properties are NOT allowed.
Show Child Parameters
Response
201 application/json
Response
201 application/json
A response containing an integration instance auth credential.
IntegrationInstanceAuthCredential
IntegrationInstanceAuthCredential
Object containing metadata for an integration instance auth credential.
One Ofidstring(base64url)required
The resource ID.
>= 16 characters<= 16 characters
Example:4UdXnoaDYYJsH_Ir
integration_instanceobjectrequired
Short-hand descriptor of an integration instance.
Show Child Parameters
missing_permissionsarray[object]required
List of detected missing permissions required to enable the full functionality of the given integration instance.
Show Child Parameters
taintedbooleanrequired
Indicates that the credential is no longer valid and must be replaced with a new valid credential.
Example:false
expires_atstring | null(date-time)required
Timestamp denoting when the when the credential will expire in RFC-3339 format with a “T” character separating date from time within the field value.
When expired, the credential must be replaced with a new valid credential to re-enable full functionality for the given integration instance.
A null value indicates no known expiration time.
Example:2025-04-01T07:20:50Z
created_atrequired
typestringrequired
Allowed values:oauth
post/integration-instances/{id}/auth-credential
Path Parameters
Body
{}
201 application/json