goauthentik / goauthentik/authentik

API: Referencing responses via components.responses

Open
#3,902 3 comments 0 reactions 0 assignees View on GitHub
enhancement pr_wanted
Dominant language
Python
Stars
25.6k
Forks
2k
Avg merge
1d 1h
Merged PRs (30d)
644

Description

**Describe your question/**
While repairing a the description document to be valid, the [changes](https://github.com/goauthentik/authentik/commit/0ff2ac7dc2cd431894bd50b46cf6ed5babe6f21d) do not make use of[ "components.responses"](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#fixed-fields-6) to reference the response. Instead the MediaType/Response get defined for each code for each PathItem.

I propose to define the 400/403 responses in components/responses and reference instead.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.