> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-well-known.md).

# /.well-known

OAuth2 **endpoint discovery document** (RFC 8414 server metadata). A public, unauthenticated document advertising fylr's OAuth2 issuer and endpoints so that clients can configure themselves. fylr is **not** an OpenID Connect provider — the document is served under the path OIDC clients conventionally probe, but carries no id-token signing metadata.

Served at the server root (`/.well-known/openid-configuration`) — **not** under `/api/v1`. The endpoint URLs it returns are absolute, built from the instance's configured external URL (`fylr.externalURL`), and point at `/api/oauth2/*`.

The route is not method-restricted: any HTTP method returns the same metadata document with status `200`.

### `GET /.well-known/openid-configuration` — Fetch the OpenID Connect provider metadata.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/.well-known/openid-configuration" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-c66962d021f9281075604517b7590deaf0d3f984%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}