In the Swagger REST docs specify what is optional

Within the swagger docs detail what is optional in the post requests.  For example, the following end point post /auth/token/designer has an example scheme of {
 "nameSpace": "string",
 "portalUrl": "string",
 "accessToken": "string",
 "clientId": "string",
 "clientSecret": "string",
 "refreshToken": "string",
 "authorizationCode": "string",
 "redirectUri": "string",
 "state": {}
}

But only the portalUrl and accessToken values seem to be required.  Additionally, could fill you fill out any properties that are missing such as the child properties of state object in the above example.