Schema on site is not authoritative nor complete as you’ve discovered 
https://github.com/json-api/json-api/issues/867
https://github.com/json-api/json-api/issues/1011#issuecomment-209496847
https://github.com/json-api/json-api/pull/440#issuecomment-151006988
Also see Development of a validation tool