I wonder how the get diagram call from the rest api works. I have a few process definitions deployed but all of them have the diagram field set to null. Am I supposed to include some kind of file in the deployment?
The diagram of a process definition can be an image (jpeg, png, svg, gif) that must deployed along with the BPMN XML. By convention, it must have the same name as the BPMN XML but with a different suffix.
If you are interested in displaying a diagram in a web application, I suggest fetching the BPMN XML instead (via GET /process-definition/{id}/xml) and using bpmn.js to render it.