fixed contract between the rest client and the gallery service