As part of #102, the first step is to draft the API schema in OpenAPI and get feedback from the community.