Skip to content

Retrieve a service integration details

Request

Show service integration details With the exception of Pingdom integration, all other integrations are using per-service URL for connection.

Security
ApiKeyAuth
Path
subdomainstringrequired

Unique subdomain of requested Hub.

service_idinteger, >= 1required

id of the service

integration_slugstringrequired

Integration slug

Enum:"generic_hook""generic_hook_v2""ilert""isdownapp""new_relic""opsgenie""pager_duty""pingdom""site_247""statusgator"
Query
api_versionstring

Api version

Value:"V3-R1"
curl -i -X GET \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/services/{service_id}/integrations/{integration_slug}?api_version=V3-R1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
enabledboolean

Is integration enabled on this service

Example:true
slugstring
Enum:"generic_hook""generic_hook_v2""ilert""isdownapp""new_relic""opsgenie""pager_duty""pingdom""site_247""statusgator"
Example:"generic_hook_v2"
versionstring

Version of the integration.
Currently available versions:

  • v1 - basic integrations available in StatusHub for long time,
  • v2 - more capable integrations. All newly introduced integrations will be added in v2 version.
Enum:"v1""v2"
Example:"v2"
urlstring or null, (uri)

Except for Pingdom integration, url is unique per-Service URL that should be used to connect 3rd party service to StatusHub Service.
Behavior of this field varies between v1 and v2 integrations:

  • For v1 integrations, this URL share same token part between integrations and url is never blank,
  • For v2 integrations, each integration may use different token.
    url is blank if v2 integration is not enabled.
Example:"https://app.statushub.io/hooks/generic_hook_v2?token=a18331da-19a5-46f1-8bfa-06a6a31f1d10"
Response
{ "enabled": true, "slug": "generic_hook_v2", "version": "v2", "url": "https://app.statushub.io/hooks/generic_hook_v2?token=a18331da-19a5-46f1-8bfa-06a6a31f1d10" }