There is a single example in the graphql mutation documentation section that covers the usage of ref types, and it appears to be wrong. This is in addition to the generated mutations and their associated types not being covered in any detail whatsoever.
Questions this has caused that I haven’t been able to figure out the answers to after several hours of whacking at it:
- Why are non-id fields required to create a reference to an item?
- Why does submitting a reference to an object with an id create an item with that id, such that using upsert to add actual data to that item is required?
- What are the actual definitions of the ref types?