Describing contents of JWT token in OpenAPI

Question

I am building a REST API that uses data in the JWT token to perform some operations. (E.g. verifying the ownership of the data, so for some cases, I might send user_id or something like that in the JWT token).

Is that possible to describe the expected contents of the JWT token using OpenAPI?

user_113116 · Answer

This is not supported as of OpenAPI 3.1, but there's an existing feature request:
Allow payload definition for JWT schema

Describing contents of JWT token in OpenAPI

1 Answers