---
title: "Test a status check endpoint configuration."
method: POST
path: "/status-checks/{runTestEndpoint}"
tags: ["health checks"]
---

# Test a status check endpoint configuration.

`POST /status-checks/{runTestEndpoint}`

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

## Query parameters

- `teamId` string, required

## Request body

- TestEndpointConfigurationRequest
  - `endpointConfiguration` EndpointConfiguration, required
    - `url` string, url, required — The URL of the status check
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' — The method type of the status check
    - `headers` object — Optional request headers to be used when the status check is invoked
    - `payload` string — Payload for POST type of request
    - `headersArn` string — Optional request headers pulled from a remote AWS resource holding JSON-encoded key-values that make up the headers
  - `teamExternalIntegration` TeamExternalIntegrationReference — Represents the configuration for referencing an external integration
    - `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' — The type of the external integration for the health check to be created/updated
    - `observabilityToolType` 'DATADOG' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'AWS' | 'AZURE' — The observability tool type of the external integration for the health check to be created/updated
    - `domain` string — The domain of the observability tool type of the external integration for the health check to be created/updated
    - `name` string, required — The name of the external integration for the health check to be created/updated
  - `webhookId` string
  - `integrationSpecificValues` object — Map of values required for a specific integration, for example AWS credentials AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY

## Other responses

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

---

[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/70fe938a0b35/schema)