1. i'd recommend [the buf docs](
https://buf.build/authzed/api/docs/main:authzed.api.v1) for understanding the shapes of requests, and i'd recommend the tests for your client library (in the client library repo) as a resource for full examples. we don't have much example documentation otherwise. you also may not find
DiffSchema
in the tests - it's a relatively new API and i haven't had a chance to add it yet.
1. no. the body that you write to a
WriteSchema
call is the text of the schema. unless you're asking about calling an HTTP API rather than a gRPC API?