---
title: "Set the external impact-metrics source."
method: POST
path: "/api/admin/impact-metrics/external-source"
tags: ["Metrics"]
---

# Set the external impact-metrics source.

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

**Enterprise feature**

Updates the configuration of the external impact-metrics source (any Prometheus-compatible endpoint).

## Request body

- SetExternalImpactMetricsSourceSchema — Configuration for connecting to an external impact-metrics source (any Prometheus-compatible endpoint). A valid URL must be supplied whenever `enabled` is true, including when re-enabling after a previous disable.
  - `enabled` boolean, required — Whether the external impact-metrics source is active. When `true`, `url` must be a valid non-empty URL.
  - `url` string — Base URL of the external impact-metrics source. 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. Required (non-empty, valid URL) when `enabled` is true; an empty string is discarded when `enabled` is false.

## Response `200`

This response has no body.

## Other responses

- `400` — The request data does not match what we expect.
- `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)