---
title: "Validate if the given authority is reachable from the server"
method: POST
path: "/api/Settings/is-valid-authority"
tags: ["Settings"]
---

# Validate if the given authority is reachable from the server

`POST /api/Settings/is-valid-authority`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Settings/is-valid-authority`
- Auth: API key in header `x-api-key`

## Request body

- AuthorityValidationDto
  - `authority` string, nullable

## Response `200`

OK

- 0 | 1 | 2 | 3 | 4: Members: - `0` — Success - `1` — InvalidAuthority - `2` — Failure - `3` — NotApplicable - `4` — MissingHttps

## Changes

- **2026-04-01** `3dfbcae62b15`: 3 breaking
  - the response's body type changed from `boolean` to `integer`, and format from no format to `int32` for status `200` (media type: text/plain)
  - the response's body type changed from `boolean` to `integer`, and format from no format to `int32` for status `200` (media type: application/json)
  - the response's body type changed from `boolean` to `integer`, and format from no format to `int32` for status `200` (media type: text/json)
- **2025-08-03** `8d18e89366d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Settings/is-valid-authority/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)