added a note about metadata to the API spec