Update API specs

Added Soft Descriptor, new Return fields, etc