first commit of api spec

I'm not sure about this field name. I think I'd prefer the field to be called `closed` and/or for a date of the closure to be included. What does everyone else think?