My suggestion is to add a description parameter to the__init__ methods ofAPIKeyQuery(SecurityBase):,APIKeyHeader(SecurityBase): andAPIKeyCookie(SecurityBase): and use it to initialize theAPIKey object. This allows for a description in thesecuritySchemes objects of theopenapi.json and therefore in the Swagger and Redoc documentation.

class SecurityBase(BaseModel): already has an attributedescription: Optional[str] = None.
class APIKey(SecurityBase): inherits from SecurityBase.

The classesAPIKeyQuery(SecurityBase):,APIKeyHeader(SecurityBase): andAPIKeyCookie(SecurityBase): initialize anAPIKey object in their__init__ method. They initialize it with some kwargs and thename parameter, but currently without a description parameter.

Example: usingAPIKeyQuery(name="X-Auth-Key", auto_error=False, description="My description") would look likt this in Redoc: