---
title: "Validate an external impact-metrics source URL."
method: POST
path: "/api/admin/impact-metrics/external-source/validate"
tags: ["Metrics"]
---

# Validate an external impact-metrics source URL.

`POST /api/admin/impact-metrics/external-source/validate`

**Enterprise feature**

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.

## Request body

- ValidateExternalImpactMetricsSourceSchema — Request body for validating an external impact-metrics source URL. The URL is checked on the fly and is not persisted.
  - `url` string, required — 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 `200`

validateExternalImpactMetricsSourceResultSchema

- ValidateExternalImpactMetricsSourceResultSchema — Result of validating an external impact-metrics source URL. The endpoint always returns 200; failures are reported in the `error` field while `metrics` is empty.
  - `metrics` string[], required — List of metric names discovered at the supplied URL. Empty when the URL could not be validated.
  - `error` string — Human-readable explanation of why the URL could not be validated. Omitted on success.

## Other responses

- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- `415` — The operation does not support request payloads of the provided type. Please ensure that you're using one of the listed payload types and that you have specified the right content type in the "content-type" header.

---

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