is this https://github.com/cerbos/cerbos/blob/main/api/public/cerbos/policy/v1/policy.proto the closest thing to a schema for refrence if I feel like the examples are not cutting it

I recommend installing Cerbos locally:

docker run --rm --name cerbos -t \
  -v $(pwd)/policies:/policies \
  -p 3592:3592 \
  <http://ghcr.io/cerbos/cerbos:latest|ghcr.io/cerbos/cerbos:latest> server

Then you can view an OpenAPI (swagger) schema in a web browser http://localhost:3592

ic

@Dmitry Meyerson what do you feel is missing from the examples? We will definitely take any feedback onboard and improve them

Also if JSON schema is more your thing, we have that here: https://api.cerbos.dev/latest/cerbos/policy/v1/Policy.schema.json You can wire it up to your editor for autocomplete and validation: https://docs.cerbos.dev/cerbos/latest/policies/authoring_tips.html#_editing_policies

no I think this covers it - I wish it was a little easier to find, otherwise this is good