Hi Thomas,
The description property in the DataContext can be considered to be decremented. The metadata property includes, as you note, a description property, which is visible in the “info” menu in the Case Table. You can retrieve the metadata through the API. You can create a metadata object when you create a data context through the API. You cannot at this time update it through the API.
Jonathan