# JsonApi Schema on FAQ is incorrect

**URL:** <https://discuss.jsonapi.org/t/jsonapi-schema-on-faq-is-incorrect/556>\
**Category:** Uncategorized\
**Created:** [June 13, 2016, 2:13pm UTC](https://discuss.jsonapi.org/t/jsonapi-schema-on-faq-is-incorrect/556 "2016-06-13T14:13:29Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![brainwipe](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.jsonapi.org/brainwipe/32/209_2.png) [@brainwipe](https://discuss.jsonapi.org/u/brainwipe)\
**Post date:** [June 13, 2016, 2:13pm UTC](https://discuss.jsonapi.org/t/jsonapi-schema-on-faq-is-incorrect/556/1 "2016-06-13T14:13:29Z")

</div>

Using the schema here: [http://jsonapi.org/faq/#is-there-a-json-schema-describing-json-api](http://jsonapi.org/faq/#is-there-a-json-schema-describing-json-api) (also here: [https://github.com/json-api/json-api/blob/gh-pages/schema](https://github.com/json-api/json-api/blob/gh-pages/schema))  
And the data from the homepage here: [http://jsonapi.org/](http://jsonapi.org/)  
I used the validator here: [http://www.jsonschemavalidator.net/](http://www.jsonschemavalidator.net/)

And the validation failed saying that `data` was the only allowed top level element. If I took away `links` and `jsonapi` then it validated OK.

I don’t have the time/need to fix it, posting here in case anyone does - or anyone runs into the same problem.

---

<div class="post-metadata">

**Author:** ![brainwipe](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.jsonapi.org/brainwipe/32/209_2.png) [@brainwipe](https://discuss.jsonapi.org/u/brainwipe)\
**Post date:** [June 13, 2016, 2:34pm UTC](https://discuss.jsonapi.org/t/jsonapi-schema-on-faq-is-incorrect/556/2 "2016-06-13T14:34:38Z")

</div>

I’ve had a bit more of a play with this (because I need the schema for my work) and I found that there is a problem with the top level `links` in the example. If you remove that section, the validation works well. Unfortunately, the validator goes a little berserk when it is included, so it’s difficult to tell what has broken!

---

<div class="post-metadata">

**Author:** ![bf4](https://sea2.discourse-cdn.com/flex016/user_avatar/discuss.jsonapi.org/bf4/32/54_2.png) [@bf4](https://discuss.jsonapi.org/u/bf4)\
**Post date:** [June 17, 2016, 1:49pm UTC](https://discuss.jsonapi.org/t/jsonapi-schema-on-faq-is-incorrect/556/3 "2016-06-17T13:49:52Z")

</div>

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/867)

[https://github.com/json-api/json-api/issues/1011#issuecomment-209496847](https://github.com/json-api/json-api/issues/1011#issuecomment-209496847)

[https://github.com/json-api/json-api/pull/440#issuecomment-151006988](https://github.com/json-api/json-api/pull/440#issuecomment-151006988)

Also see [Development of a validation tool](http://discuss.jsonapi.org/t/development-of-a-validation-tool/416)