What is the recommended way to convert a lead into a deal using the API?
There is no dedicated endpoint for converting a Lead to a Deal, but you can use the following sequence to replicate UI behavior.
GET /leads/<lead id> - get a lead data
POST /deals - use org./person data from a lead for a deal request body
DELETE /leads/<lead id> - if there is no need in lead anymore it can be deleted.