---
title: "Update a team integration that is compatible with Health Checks."
method: PUT
path: "/external-integrations/status-check"
tags: ["external-integrations"]
---

# Update a team integration that is compatible with Health Checks.

`PUT /external-integrations/status-check`

Requires the privilege [`INTEGRATIONS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `type` 'JIRA' | 'DATADOG' | 'DATADOG_EU' | 'DATADOG_US3' | 'DATADOG_US5' | 'DATADOG_US1_FED' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'K6' | 'LOAD_GENERATOR_CUSTOM' | 'AWS' | 'AZURE' | 'GCP'
- `observabilityToolType` 'DATADOG' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'AWS' | 'AZURE'
- `domain` string
- `name` string, required
- `teamId` string, required

## Request body

- CreateTeamExternalIntegrationRequest — Represents the configuration for an external integration
  - `url` string, url — Uri of the configuration
  - `headers` object — Headers of configuration
  - `headersArn` string — Arn of remote header configuration
  - `name` string, required — Name of configuration
  - `privateNetwork` boolean, required — Is private network
  - `lastAuthenticationStatus` 'AUTHENTICATED' | 'UNAUTHENTICATED' | 'UNTESTED', required — Last authentication status
  - `integrationSpecificValues` object — Map of values required for a specific integration, for example AWS credentials AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
  - `multiSelectTags` object — The tags associated with this integration

## Response `default`

default response

- TeamExternalIntegrationResponse
  - `identifier` string
  - `userId` string
  - `type` 'JIRA' | 'DATADOG' | 'DATADOG_EU' | 'DATADOG_US3' | 'DATADOG_US5' | 'DATADOG_US1_FED' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'K6' | 'LOAD_GENERATOR_CUSTOM' | 'AWS' | 'AZURE' | 'GCP'
  - `observabilityToolType` 'DATADOG' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'AWS' | 'AZURE'
  - `domain` string
  - `url` string, url
  - `headers` object
  - `headersArn` string
  - `name` string
  - `teamId` string
  - `privateNetwork` boolean
  - `canBeUsedAsStatusCheck` boolean
  - `lastAuthenticationStatus` 'AUTHENTICATED' | 'UNAUTHENTICATED' | 'UNTESTED'
  - `integrationSpecificValues` object
  - `createdAt` string, date-time
  - `multiSelectTags` object

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: INTEGRATIONS_WRITE

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/36ee938323f0/schema)