[BETA] Validate an external impact-metrics source URL.

View as Markdown
**Enterprise feature** **[BETA]** This API is in beta state, which means it may change or be removed in the future. Tests an external impact-metrics source URL on the fly without persisting it. Returns the list of metric names found at the URL on success, or an `error` string explaining what went wrong. Always responds with 200; failures are reported in the body.

Authentication

Authorizationstring
API key needed to access this API
OR
AuthorizationBearer
API key needed to access this API, in Bearer token format

Request

validateExternalImpactMetricsSourceSchema
urlstringRequired

Base URL of the external impact-metrics source to test. Basic-Auth credentials may be embedded in the URL (e.g. https://user:pass@metrics.example.com); they are extracted into an Authorization header on outbound requests.

Response

validateExternalImpactMetricsSourceResultSchema
metricslist of strings
List of metric names discovered at the supplied URL. Empty when the URL could not be validated.
errorstring

Human-readable explanation of why the URL could not be validated. Omitted on success.

Errors

401
Unauthorized Error
403
Forbidden Error
415
Unsupported Media Type Error